1. 为什么要在 .NET 里折腾 MCP ToolMCPModel Context Protocol是 Anthropic 提出的开放协议核心目标是让大模型能以一种统一的方式调用外部工具。你可以把它理解成「给模型用的 USB-C 接口」不管背后是查数据库、跑脚本还是调内部 API只要按 MCP 规范暴露成 Tool支持 MCP 的客户端就能直接发现并调用它。对 .NET 开发者来说官方 C# SDK 的出现让这件事变得顺手很多。它由早期的 mcpdotnet 演进而来基于 Microsoft.Extensions.AI 体系构建目前处于 preview 阶段已经提供了ModelContextProtocol和ModelContextProtocol.AspNetCore两个关键包。前者负责核心协议与 Stdio 传输后者让你用几行代码就能在 ASP.NET Core 里挂出一个基于 SSE 的 MCP Server。这篇内容聚焦一个完整链路用 MCP C# SDK 搭建 MCP Tool覆盖 Stdio 与 SSE 两种传输方式从依赖引入、工具注册、传输切换到用 curl 和客户端实际验证调用。适合需要在本地或远程暴露工具能力的 .NET 开发者目标是一次跑通注册、调用与传输切换。下面给出的 csproj 片段、Program.cs 骨架和 appsettings.json 配置都可以直接复制改。2. TaoToken 前置把模型调用能力接进来MCP Tool 本身只负责「暴露能力」真正决定模型会不会调用、怎么调用还得有一个能对话的模型入口。我在做这类验证时习惯先把模型侧的 Key 和接入信息准备好这样 Tool 注册完就能立刻端到端跑通而不是卡在「工具写好了但没模型可测」。TaoToken 在这里扮演的是模型接入层官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 可以了解整体能力API 入口是 https://taotoken.net/api这个地址不加 UTM。你需要先去控制台创建一个 API Key再根据用途选择入口只是验证模型能不能正常对话、Tool 描述能不能被理解用模型对话入口https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite要长期跑编码类、Agent 类任务用 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite管理 Key、查看用量进控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite直接创建 API Keyhttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite接入细节和参数说明看文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite如果你用的是 Claude Code 这类工具链Anthropic 兼容入口在这里https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecodeutm_campaignrewrite注意Key 只放在服务端环境变量或用户机密里不要硬编码进仓库也不要在前端暴露。3. 可复制配置csproj、Program.cs 与 appsettings.json3.1 项目依赖csproj新建一个 ASP.NET Core 空项目然后在 csproj 里加上 MCP 相关包。SSE 场景需要ModelContextProtocol.AspNetCoreStdio 场景需要ModelContextProtocol。两个都装也不冲突方便你随时切换传输方式。Project SdkMicrosoft.NET.Sdk.Web PropertyGroup TargetFrameworknet9.0/TargetFramework Nullableenable/Nullable ImplicitUsingsenable/ImplicitUsings /PropertyGroup ItemGroup PackageReference IncludeModelContextProtocol Version0.1.0-preview.4 / PackageReference IncludeModelContextProtocol.AspNetCore Version0.1.0-preview.4 / PackageReference IncludeMicrosoft.Extensions.AI Version9.0.0-preview.1 / /ItemGroup /Project版本号以你实际拉取到的 preview 为准用dotnet add package ModelContextProtocol.AspNetCore --prerelease会自动选最新预览版。3.2 SSE 模式的 Program.cs 骨架SSE 模式适合远程暴露客户端通过 HTTP 长连接接收事件。核心就三步注册 McpServer、扫描程序集里的 Tool、映射 MCP 端点。using ModelContextProtocol.Server; var builder WebApplication.CreateBuilder(args); // 注册 MCP Server 相关服务并从当前程序集扫描所有 Tool builder.Services .AddMcpServer() .WithToolsFromAssembly(); var app builder.Build(); // 映射 MCP 的 SSE 端点默认路径是 /sse app.MapMcp(); app.Run();MapMcp()默认会把 SSE 端点挂在/sse消息回传路径挂在/message。如果你要改路径可以在MapMcp里传参但默认值已经够用。3.3 定义一个可被调用的 ToolTool 类加[McpServerToolType]方法加[McpServerTool]再用[Description]描述功能——这段描述很关键模型就是靠它判断该不该调用。using System.ComponentModel; using ModelContextProtocol.Server; [McpServerToolType] public static class EchoTool { [McpServerTool, Description(Echoes the input back to the client.)] public static string Echo(string message) { return hello message; } }默认 Tool 名就是方法名Echo你也可以用Name echo显式指定。SDK 现在支持在方法参数里直接注入服务比如注入IChatClient做翻译类 Tool不用再自己写 service locator。3.4 Stdio 模式的 Program.cs 骨架Stdio 模式是把程序当成一个可执行进程通过标准输入输出通信。它更适合本地单机场景但用第三方 Server 时要留意安全边界因为对方程序会在你本机执行。using Microsoft.Extensions.Hosting; using ModelContextProtocol.Server; var builder Host.CreateApplicationBuilder(args); builder.Services .AddMcpServer() .WithStdioServerTransport() .WithToolsFromAssembly(); await builder.Build().RunAsync();注意 Stdio 模式不要用 WebApplication用 Host 即可因为它不需要监听端口。3.5 appsettings.json 配置把模型接入信息和 MCP 相关参数放进配置避免散落在代码里。{ Mcp: { ServerName: aspnet-mcp-sample, SsePath: /sse }, ModelProvider: { BaseUrl: https://taotoken.net/api, ApiKey: , Model: your-model-name } }ApiKey留空实际运行时用环境变量ModelProvider__ApiKey覆盖或者用dotnet user-secrets注入。4. 验证请求从 curl 到客户端调用4.1 启动 SSE Server 并用 curl 探活先跑起来dotnet run --urls http://localhost:5000SSE 端点是长连接直接用 curl 看事件流curl -N http://localhost:5000/sse正常的话你会看到类似event: endpoint加一行data: /message?sessionIdxxx的输出说明 SSE 通道建立成功后续消息要发到/message这个地址。4.2 用 MCP Inspector 做可视化验证官方 Inspector 是最省事的调试方式npx modelcontextprotocol/inspector打开界面后Transport Type 选 SSEURL 填http://localhost:5000/sse点 Connect。连接成功后点 List Tools应该能看到Echo。选中它在右侧填message参数点 Run Tool返回hello xxx就说明整条链路通了。4.3 用 C# 客户端代码调用SDK 也支持写客户端方便你集成到自己的程序里using ModelContextProtocol.Client; var client await McpClientFactory.CreateAsync(new() { Id aspnet-sample, Name ASP.NET McpServerSample, TransportType TransportTypes.Sse, Location http://localhost:5000/sse, }); foreach (var tool in await client.ListToolsAsync()) { Console.WriteLine(${tool.Name} ({tool.Description})); } var result await client.CallToolAsync( Echo, new Dictionarystring, object? { [message] MCP! }, CancellationToken.None); Console.WriteLine(result.Content.First(c c.Type text).Text);输出hello MCP!就对了。这段代码和 Inspector 做的事一样先列 Tool再调用指定 Tool。4.4 切到 Stdio 验证把 Program.cs 换成 Stdio 骨架编译成可执行文件后在支持 Stdio 的客户端里配置命令和参数即可。比如配置里填可执行文件路径客户端会以子进程方式启动它通过标准输入输出收发 JSON-RPC 消息。调试时如果遇到文件被占用去进程管理器里结束残留进程再重试。5. 本篇常见错排查连接 SSE 后 List Tools 为空多半是 Tool 类没加[McpServerToolType]或者方法不是public static。WithToolsFromAssembly()只扫描当前入口程序集Tool 写在别的类库里需要额外指定程序集。curl 访问 /sse 没反应确认app.MapMcp()在app.Run()之前调用且没有中间件提前短路了请求。SSE 是长连接curl 要加-N关闭缓冲才能实时看到事件。Stdio 模式启动即退出Stdio Server 依赖父进程通过标准输入持续发消息如果你直接在终端裸跑它收不到输入就会结束。要用支持 Stdio 的客户端来拉起它。Tool 参数模型不识别[Description]要写在参数上描述清楚每个参数含义。模型靠这些元数据决定传什么值描述含糊会导致调用失败或传错参数。端口冲突或路径不对默认 SSE 路径是/sse如果你改了MapMcp的参数客户端 Location 也要同步改。端口用--urls指定别和本机其他服务撞车。Key 相关报错模型侧返回鉴权失败时先确认ModelProvider__ApiKey环境变量是否生效再检查 BaseUrl 是否写成了带 UTM 的地址——API 调用应该用 https://taotoken.net/api 这个不带参数的入口。6. 继续往下走工具注册和传输切换跑通之后下一步通常是把它接到真实模型上做端到端验证。你可以先用模型对话入口确认 Tool 描述能被正确理解https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite如果要长期跑编码或 Agent 类任务Coding Plan 更合适https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite接入过程中遇到参数或协议细节问题直接查文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewriteKey 的创建和管理在控制台完成https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite我自己的习惯是先把 Echo 这种无依赖的 Tool 跑通确认 SSE 和 Stdio 两条路都能调再往里加需要注入服务的复杂 Tool。这样出问题时排查范围小不会一上来就被依赖注入和传输层的问题混在一起。