SuperAPI AI 工具集

dotnet-mcp-builder

智能体与模型

查看项目

更新于 10-15 21:52

技能介绍

用途:帮助编写生产级 .NET MCP 服务器与基础客户端,基于 Microsoft 与 MCP 项目维护的官方 ModelContextProtocol NuGet 包,面向稳定 2.x 线与 2026-07-28 规范。

主要能力:覆盖 STDIO 与 Streamable HTTP 传输、工具/提示/资源三类原语、elicitation、采样、roots、MCP Apps、参数补全、日志与进度通知、客户端编写及测试(MCP Inspector、内存测试、mock、CI)。提供按任务加载的参考文档,如 references/packages.md、transport-stdio.md、transport-http.md、tool-primitive.md、elicitation.md、client.md、testing.md 等。

使用方式:服务器是普通 Microsoft.Extensions.Hosting 或 WebApplication 应用,通过 DI 注册,例如 builder.Services.AddMcpServer().WithStdioServerTransport().WithToolsFromAssembly()。原语为带特性的 C# 方法([McpServerToolType]+[McpServerTool] 等),参数由 JSON-RPC 绑定,SDK 依据签名与 [Description] 生成 JSON Schema。新增原语需同时写出注册行。

关键规则:固定使用最新 2.x 稳定包而非预览版;STDIO 服务器禁止写 stdout,需设置 LogToStandardErrorThreshold = LogLevel.Trace;HTTP 在 2.x 默认无状态,2026-07-28 修订版无 HTTP 会话;SSE-only 已弃用,改用 Streamable HTTP;roots、sampling、MCP 通道日志已弃用(警告 MCP9005),新设计应使用多轮往返 input_required 模式与 ILogger;始终为工具和参数添加 [Description];不要臆造 API。

适用场景:新建 STDIO 或 HTTP MCP 服务器、增改工具/提示/资源、工具中途向用户提问、返回交互式 UI、编写 MCP 客户端、搭建测试与 CI。

限制:资料未提供具体安装命令、价格或平台信息;新扩展包(Tasks、Apps)需先查其文档;遇到问题可参考 EverythingServer 示例。