C# MCP SDK

概览

C# MCP SDK（代码仓库：modelcontextprotocol/csharp-sdk）是由 Microsoft 合作开发的 Model Context Protocol 官方 .NET SDK。它允许 .NET 开发者使用地道的 C# API 实现 MCP 服务器与客户端，使 AI 智能体能够便捷地连接到 .NET 应用、企业数据源、内部 API 及自定义工作流。

该 SDK 于 2026 年 3 月发布稳定的 v1.0 版本，全面支持 2025-11-25 MCP 规范。作为官方 MCP 生态中的 Tier 1 级别 SDK，它是 C#/.NET 团队参与日益发展的 MCP 生态系统的推荐方式。

核心特性

• 完整 MCP 规范支持：实现最新的 2025-11-25 协议，包含工具（Tools）、资源（Resources）、提示（Prompts）、启发（Elicitation）、采样（Sampling）以及实验性任务（Tasks）。
• 三个 NuGet 包：
  • ModelContextProtocol.Core — 客户端和底层服务器的轻量依赖。
  • ModelContextProtocol — 适用于大多数场景的全功能包。
  • ModelContextProtocol.AspNetCore — 与 ASP.NET Core 无缝集成，支持 HTTP/SSE 传输。
• 简易工具定义：通过属性装饰方法或使用流式 API，将 C# 函数暴露为 MCP 工具，并自动生成 JSON Schema。
• 内置授权机制：原生支持 OAuth 2.1、OpenID Connect 发现、PKCE 及增量范围同意。
• 多传输协议：支持 stdio、HTTP、SSE 及 Streamable HTTP。
• Microsoft.Extensions.AI 集成：与 Semantic Kernel 及其他 .NET AI 库流畅互操作。
• 生产就绪：提供可观测性、日志记录、依赖注入、HttpContext 访问及 AOT 兼容选项。
• 完善的文档：完整 API 文档位于 csharp.sdk.modelcontextprotocol.io。

工作原理

构建 MCP 服务器（最小示例）

using ModelContextProtocol;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddMcpServer()
    .WithHttpTransport()
    .WithTools<MyCustomTools>();

var app = builder.Build();
app.MapMcp();
app.Run();

简单定义工具：

public class MyCustomTools
{
    [McpTool]
    public string GetWeather(string city) 
        => $"{city} 天气晴朗";
}

AI 智能体（如 Claude Desktop、Cursor 等）随后可自动发现并调用这些工具。

应用场景

• 企业数据集成：安全地向 AI 智能体开放内部数据库、CRM 系统或业务 API。
• 面向智能体的 .NET 工具：构建 MCP 服务器，使 AI 能控制 dotnet CLI、Roslyn 分析器、NuGet 包或 Azure 资源。
• 自定义 AI 工作流：将遗留 .NET 服务连接到现代智能体应用。
• 混合 AI 应用：将 MCP 与 Semantic Kernel 或 Microsoft.Extensions.AI 结合，提供丰富的智能体体验。
• 内部开发者工具：创建组织专属的代码生成、部署或监控工具。

快速开始

1. 安装主包：

   dotnet add package ModelContextProtocol
   

2. 按照 GitHub 仓库 或 SDK 文档 中的官方快速入门指南进行操作。

3. 探索 microsoft/mcp-dotnet-samples 中的丰富示例。

该 SDK 适用于控制台应用程序、ASP.NET Core、Azure Functions 等。完全支持服务器和客户端实现。

优势

C# MCP SDK 将模型上下文协议的能力引入 .NET 生态系统，提供了熟悉的模式、强类型、依赖注入和企业级安全。它降低了 .NET 团队构建生产级 MCP 服务器的门槛，同时保持与更广泛的 MCP 生态系统（Claude、Cursor、Gemini CLI 等）的完全兼容性。

作为由微软维护的一级官方 SDK，它能及时获得与 MCP 规范演进保持同步的更新，并被广泛用于内部工具和公共 AI 集成。

官方链接：

• GitHub: https://github.com/modelcontextprotocol/csharp-sdk
• 文档: https://csharp.sdk.modelcontextprotocol.io/
• .NET 博客公告: https://devblogs.microsoft.com/dotnet/release-v10-of-the-official-mcp-csharp-sdk/