Bitzsoft.Integrations.McpServer 1.0.0-alpha.7

Bitzsoft.Integrations.McpServer

MCP (Model Context Protocol) 服务端集成，快速构建符合 MCP 标准的工具服务，支持 HTTP 传输和标准 I/O 传输。

功能特性

• 基于 ModelContextProtocol 官方库构建，完全兼容 MCP 协议规范
• 同时支持 HTTP 传输和 Stdio 传输两种模式
• 使用 [McpServerToolType] 和 [McpServerTool] 特性声明式定义工具
• 内置实用工具（日期时间、UUID 生成、文本统计等），可按需扩展
• SSE 客户端配置支持，可连接远程 MCP 服务端
• ASP.NET Core 集成，一行代码完成服务注册

安装

dotnet add package Bitzsoft.Integrations.McpServer

或直接在项目文件中添加：

<PackageReference Include="Bitzsoft.Integrations.McpServer" Version="*" />

配置

在 appsettings.json 中添加以下配置节：

{
  "MCPOptions": {
    "Enabled": true,
    "ServerName": "BitzOrcas.MCP",
    "ServerVersion": "1.0.0"
  },
  "MCPSseClientOptions": {
    "Name": "MyMcpClient",
    "Url": "https://mcp-server.example.com/sse",
    "UseStreamableHttp": true,
    "ConnectionTimeout": "00:00:30",
    "AdditionalHeaders": {
      "Authorization": "Bearer your-token"
    }
  }
}

MCPOptions

MCPSseClientOptions

注册服务

在 ASP.NET Core 应用的 Program.cs 中注册 MCP 服务：

using Bitzsoft.Integrations.McpServer.Models;

var builder = WebApplication.CreateBuilder(args);

// 方式一：使用默认配置
builder.Services.AddMCPServer();

// 方式二：代码内配置
builder.Services.AddMCPServer(options =>
{
    options.Enabled = true;
    options.ServerName = "MyApp.MCP";
    options.ServerVersion = "2.0.0";
});

// 方式三：从 appsettings.json 绑定
builder.Services.AddMCPServer(
    options => builder.Configuration.GetSection("MCPOptions").Bind(options));

var app = builder.Build();

// 映射 MCP 端点（HTTP 传输模式需要）
app.MapMcp();

app.Run();

使用示例

定义自定义工具

创建一个静态类，使用 [McpServerToolType] 标记，并在每个工具方法上添加 [McpServerTool] 特性：

using System.ComponentModel;
using ModelContextProtocol.Server;

namespace MyCompany.Integrations.McpTools;

/// <summary>
/// 法律文档查询工具集
/// </summary>
[McpServerToolType]
public static class LegalDocumentTools
{
    /// <summary>
    /// 根据案件编号查询案件摘要
    /// </summary>
    [McpServerTool, Description("Retrieve a case summary by case number.")]
    public static string GetCaseSummary(string caseNumber)
    {
        // 实际实现应注入业务服务或数据库查询
        return $"案件 {caseNumber} 的摘要信息：合同纠纷，原告张某诉被告李某...";
    }

    /// <summary>
    /// 搜索法律条文
    /// </summary>
    [McpServerTool, Description("Search legal articles by keyword.")]
    public static string SearchLegalArticles(string keyword, int limit = 5)
    {
        return $"找到 {limit} 条与「{keyword}」相关的法律条文：\n"
             + "1. 《民法典》第一百四十三条...\n"
             + "2. 《劳动合同法》第十条...";
    }
}

工具类所在的程序集会在调用 AddMCPServer() 时通过 WithToolsFromAssembly() 自动扫描并注册。如果自定义工具位于独立程序集中，需确保在注册前已加载该程序集。

在 Controller 中调用工具（集成测试场景）

using Bitzsoft.Integrations.McpServer.Tools;
using Microsoft.AspNetCore.Mvc;

[ApiController]
[Route("api/[controller]")]
public class McpTestController : ControllerBase
{
    /// <summary>
    /// 测试 MCP 工具是否正常注册
    /// </summary>
    [HttpGet("uuid")]
    public IActionResult TestUuid()
    {
        // 直接调用本地工具方法验证逻辑
        var result = UtilityTools.GenerateUuid();
        return Ok(new { result });
    }
}

内置实用工具

本包内置了以下实用工具（定义在 UtilityTools 类中），可直接使用或作为参考：

相关包

• Bitzsoft.Integrations.AgentFramework — AI Agent 框架，可将 MCP 工具接入智能对话代理
• Bitzsoft.Integrations.SemanticKernel — Semantic Kernel 编排层
• Bitzsoft.Integrations.All — 所有集成包的统一引用