MCP General

MCP平台（.NET）

基于插件的MCP服务器平台。编写工具一次，部署到任何地方。

封装结构

插件的工作原理

在启动时， McpGenericServer 扫描 plugins/ 目录。\ 每 .dll 其中包含一个类实现 IMcpPlugin 被加载到一个隔离的\ AssemblyLoadContext 及其 Register() 方法被调用。\ 该插件注册了自己的工具、HTTP客户端、配置绑定——任何它需要的东西。

McpGenericServer.exe
└── plugins/
    ├── MyCompany.Mcp.Crm.dll       ← loaded automatically
    ├── MyCompany.Mcp.Crm.deps.json ← required for dependency resolution
    └── MyCompany.Mcp.Hr.dll        ← loaded automatically

编写插件（在单独的仓库中）

1.安装NuGet

2.实现IMcpPlugin

using McpPlatform.Core.Plugins;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;
using ModelContextProtocol.Server;

public sealed class CrmPlugin : IMcpPlugin
{
    public string Name => "Crm";
    public string Version => "1.0.0";

    public void Register(IServiceCollection services, IConfiguration configuration)
    {
        services.AddHttpClient(client =>
        {
            client.BaseAddress = new Uri(configuration["Crm:BaseUrl"]!);
        });

        services
            .AddMcpServer()
            .WithTools();
    }
}

3.正常编写工具

[McpServerToolType]
public sealed class CrmTools
{
    private readonly ICrmClient _crm;

    public CrmTools(ICrmClient crm) => _crm = crm;

    [McpServerTool(Name = "crm_get_customer"), Description("Returns customer by ID.")]
    public async Task GetCustomer(
        [Description("Customer ID")] string id,
        CancellationToken cancellationToken)
    {
        var customer = await _crm.GetCustomerAsync(id, cancellationToken);
        return new CustomerResult(customer.Id, customer.Name);
    }

    public sealed record CustomerResult(string Id, string Name);
}

4.部署

将插件的构建输出复制到 plugins/ 旁边 McpGenericServer.exe.\ 服务器在下次启动时发现并加载它——不需要重新编译。

配置

appsettings.json 或环境变量：

{
  "Mcp": {
    "PluginsDirectory": "plugins",
    "FailFastOnPluginError": false
  }
}

连接客户端

看 docs/connecting-clients.md 有关以下内容的分步说明：

• VS代码/GitHub复制人聊天(.vscode/mcp.json)
• 克劳德桌面
• 来自的程序连接。NET、Python和TypeScript
• 环境变量和 appsettings.json 配置
• 将插件放置在 plugins/ 目录

构建和测试

dotnet build McpGenericServer.sln
dotnet test McpGenericServer.sln