McpHelper.Core 1.0.9

McpHelper.Core

MCP Helper 核心库 - ASP.NET Core 中间件，用于公开程序信息查询接口，支持 MCP Server 和多种认证方式。

功能特性

• MCP Server - 支持 Streamable HTTP 和传统 SSE 两种传输模式
• MCP Client - 连接远程后端 MCP 服务并代理调用
• 程序信息查询 - 暴露版本、运行时、系统、内存等信息的 REST API
• 健康检查 - 支持依赖服务的健康状态检查
• 多种认证 - API Key、JWT 认证，可扩展数据库认证

安装

dotnet add package McpHelper.Core

依赖

目标框架

• .NET 10.0

快速开始

1. 基础使用

using McpHelper.Extensions;

var builder = WebApplication.CreateBuilder(args);

// 注册中间件
builder.Services.AddMcpHelper();

var app = builder.Build();

// 启用中间件
app.MapMcpHelper();

app.Run();

2. 完整配置

appsettings.json:

{
  "AppMiddleware": {
    "Authentication": {
      "Type": "ApiKey",
      "ApiKey": {
        "Keys": ["your-api-key"],
        "HeaderName": "X-Api-Key"
      }
    },
    "ProgramInfo": {
      "Enabled": true,
      "EndpointPrefix": "/api/program-info",
      "ProductName": "MyService",
      "ProductVersion": "1.0.0"
    },
    "Mcp": {
      "Enabled": true,
      "ServerName": "MyService",
      "ServerVersion": "1.0.0",
      "SseEndpoint": "/api/mcp",
      "EnableLegacySse": false,
      "Stateless": true
    }
  }
}

Program.cs:

using McpHelper.Extensions;

var builder = WebApplication.CreateBuilder(args);

// 一行代码注册所有中间件
builder.Services.AddAppMiddleware(builder.Configuration);

var app = builder.Build();

// 一行代码启用所有中间件
app.UseAppMiddleware();

app.Run();

配置选项

ProgramInfoOptions

MopOptions (MCP 配置)

AuthenticationOptions

API 端点

MCP 传输模式

Streamable HTTP（推荐）

{
  "Mcp": {
    "EnableLegacySse": false,
    "Stateless": true
  }
}

端点: POST /api/mcp

传统 SSE

{
  "Mcp": {
    "EnableLegacySse": true,
    "Stateless": false
  }
}

端点: GET /api/mcp/sse + POST /api/mcp/message

Stdio 模式

适用于控制台应用，通过标准输入输出通信。

var mcpOptions = new ProgramInfoOptions
{
    Mcp = new MopOptions
    {
        Enabled = true,
        TransportType = MopTransportType.Stdio,
        ServerName = "ConsoleApp"
    }
};

await mcpOptions.RunMcpServerAsync();

认证配置

API Key 认证

{
  "Authentication": {
    "Type": "ApiKey",
    "ApiKey": {
      "Keys": ["key1", "key2"],
      "HeaderName": "X-Api-Key"
    }
  }
}

JWT 认证

{
  "Authentication": {
    "Type": "Jwt",
    "Jwt": {
      "UseHostAuthentication": true,
      "RequiredRoles": ["admin"]
    }
  }
}

自定义 MCP 工具

定义工具类

using System.ComponentModel;
using ModelContextProtocol.Server;
using System.Text.Json;

[McpServerToolType]
public class CustomTools
{
    private readonly IMyService _service;

    public CustomTools(IMyService service)
    {
        _service = service;
    }

    [McpServerTool]
    [Description("计算两个数的和。参数 a：第一个数，参数 b：第二个数。")]
    public Task<string> Add(double a, double b)
    {
        return Task.FromResult(JsonSerializer.Serialize(new { a, b, result = a + b }));
    }
}

注册工具

// 注册服务
builder.Services.AddSingleton<IMyService, MyService>();

// 注册中间件
builder.Services.AddAppMiddleware(builder.Configuration);

// 注册自定义工具（推荐）
builder.Services.AddMcpLocalTool<CustomTools>();

// 或批量注册
builder.Services.AddMcpLocalTools(registry =>
{
    registry.RegisterLocalTool<CustomTools>();
    registry.RegisterLocalTool<AdminTools>();
});

后端服务代理

配置后端

{
  "Mcp": {
    "Backends": [
      {
        "Name": "RemoteService",
        "Url": "http://192.168.1.100:5000",
        "ConnectionMode": "Mcp",
        "TransportMode": "Auto",
        "McpEndpoint": "/api/mcp",
        "ApiKey": "your-key"
      }
    ]
  }
}

后端工具

扩展方法

AddMcpHelper

注册核心服务：

builder.Services.AddMcpHelper();

AddAppMiddleware

注册所有中间件（推荐）：

builder.Services.AddAppMiddleware(builder.Configuration);

AddMcpLocalTool

注册单个工具类：

builder.Services.AddMcpLocalTool<CustomTools>();

AddMcpLocalTools

批量注册工具类：

builder.Services.AddMcpLocalTools(registry =>
{
    registry.RegisterLocalTool<CustomTools>();
    registry.RegisterLocalTool<AdminTools>();
});

相关项目

• McpHelper.SQLite - SQLite 数据库认证扩展
• McpHelper.PostgreSQL - PostgreSQL 数据库认证扩展
• McpHelper.Linker - CLI 工具，动态加载 MCP 工具

许可证

MIT License