.NET 11 正式发布SDK 内置 MCP 服务器模板,一条命令生成 stdio/HTTP 本地 MCP 服务

我先联网核实 .NET 11 发布状态与内置 MCP 服务器模板的官方细节。

微软已于 2026 年 11 月 10 日正式发布 .NET 11,这版 SDK 最直接影响 AI 开发体验的一点,是内置了 MCP 服务器模板:以前在 .NET 里做 Model Context Protocol 服务,需要先单独安装预览版模板包 Microsoft.McpServer.ProjectTemplates,现在装好 .NET 11 SDK 后直接执行 dotnet new mcpserver -o MyMcpServer 就能生成一个基于官方 MCP C SDK、带可运行示例工具的完整项目,不用再先拉独立模板包。模板支持本地 stdio 传输和远程 http 传输两种形态,可选启用 Native AOT 发布和自包含发布,生成的项目里包含 Program.cs 入口、示例工具类、HTTP 主机配置文件和 server.json 发布清单,可以直接接入 GitHub Copilot 等支持 MCP 的客户端调试,也可以打包成跨平台工具发布到 NuGet。除了 MCP 模板,.NET 11 还同步更新了 C 15、ASP.NET Core、.NET MAUI、EF Core 11 和一整套 AI 相关库与框架,MEAI 提供聊天客户端和向量生成抽象,MAF 负责编排调用工具的 Agent 与工作流,MCP 模板则是把企业自有能力暴露给 AI 应用的服务端起点。需要先理清的是,内置模板解决的是 "快速生成 MCP 服务端骨架",并不等于自动把你的业务接口变成 MCP 工具;工具方法、参数校验、环境变量配置和权限治理仍需要开发者自己补,部分配套能力(如 AG-UI 托管集成、Blazor AI 组件)目前仍是预发布状态。

一、.NET 11 发布背景与支持周期

项目信息
发布日期2026 年 11 月 10 日(NET Conf 11 月 10—13 日)
版本类型STS(Standard Term Support,标准期限支持)
支持周期两年,按 .NET 支持政策执行
同期版本节点.NET 8、.NET 9 于 2026 年 11 月 10 日终止支持;需要更长生命周期可选 .NET 10(LTS)
开发环境兼容的 Visual Studio 2026,或 Visual Studio Code 加 C# Dev Kit
语言与框架C# 15、F# 11、ASP.NET Core、.NET MAUI、EF Core 11

二、内置 MCP 服务器模板:和之前的预览方案有什么不同

2.1 模板定位

MCP(Model Context Protocol)给 AI 应用提供了一套发现并调用工具、服务的通用方式。MCP 服务器就是通过这套协议把自身能力暴露给客户端(如 GitHub Copilot、支持 MCP 的 IDE 或 Agent 应用)的服务。.NET 11 SDK 自带的模板基于官方 MCP C SDK,生成的项目自带一个可运行的示例工具,开发者可以在这个骨架上直接暴露自己的业务功能。

2.2 前后变化对比

对比项.NET 10 时代(预览方案).NET 11 内置模板
获取方式先执行 dotnet new install Microsoft.McpServer.ProjectTemplates 单独安装预览包模板随 .NET 11 SDK 内置,无需安装独立模板包
SDK 要求.NET 10.0 SDK 及以上.NET 11 SDK
底层 SDK官方 MCP C# SDK官方 MCP C# SDK
示例工具get_random_numberget_random_number(保留作为测试起点)
成熟度模板包处于预览阶段随正式 SDK 发布,后续以官方文档为准

三、快速上手:从命令到生成的项目结构

3.1 创建项目

在终端执行:

dotnet new mcpserver -o MyMcpServer

进入目录并构建:

cd MyMcpServer

dotnet build

查看全部模板选项:

dotnet new mcpserver --help

3.2 生成的主要文件

文件作用
Program.cs定义应用为 MCP 服务器,注册传输类型和 MCP 工具;stdio 传输下配置 .withStdioServerTransport(),http 传输下配置 .withHttpServerTransport() 和 MapMcp()
RandomNumberTools.cs示例工具类,get_random_number 方法根据用户给定的 min/max 返回随机数,工具方法用 [McpServerTool] 标注
[MCPServerName].http(仅 HTTP 传输)定义 HTTP MCP 服务器默认主机地址和 JSON-RPC 通信配置
server.json声明服务器发布方式和位置,包含环境变量输入、CLI 参数等元数据,供 NuGet 生成客户端配置
README.md项目使用说明

3.3 模板可配置选项

选项取值说明
Framework(目标框架)net8.0 / net9.0 / net10.0 / net11.0选择项目目标 .NET 框架,默认 net11.0
MCP Server Transport Typelocal(stdio)/ remote(http)本地标准输入输出传输,或远程 HTTP 传输;默认 local
--aot开关启用 Native AOT 发布,把服务器编译为原生代码
--self-contained开关启用自包含发布,生成不依赖共享运行时的可执行文件

四、两种传输方式:stdio 与 HTTP 怎么选

4.1 对比表

维度stdio(local)http(remote)
通信通道标准输入输出HTTP 端点 + JSON-RPC
典型场景本地客户端随进程启动,如 IDE 内工具、本地 Agent多人共享、跨网络访问的远程 MCP 服务
Program.cs 配置.withStdioServerTransport().withHttpServerTransport()、MapMcp()
额外配置文件无[MCPServerName].http
客户端配置类型"type": "stdio""type": "http",填写 url

4.2 客户端配置示例

stdio 方式,在 .vscode/mcp.json 中通过 dotnet 命令启动项目:

{

"servers": {

"MyMcpServer": {

"type": "stdio",

"command": "dotnet",

"args": [ "run", "--project", "" ]

}

}

}

HTTP 方式,直接指向本地端点:

{

"servers": {

"MyMCPServer": {

"url": "http://localhost:6278",

"type": "http"

}

}

}

4.3 调试连接

  • 在 VS Code 或 Visual Studio 中打开 GitHub Copilot 聊天,切换到 Agent(代理)模式。
  • 选择工具图标,确认 MyMCPServer 和示例工具 get_random_number 出现在可用工具列表中。
  • 输入类似 "给我一个 1 到 100 之间的随机数" 的提示,Copilot 会请求调用工具,确认授权后服务器返回结果。

五、把示例工具改成自己的业务能力

5.1 工具定义方式

  • 在工具类方法上使用 [McpServerTool] 标注,方法参数即工具入参。
  • 示例 RandomNumberTools.cs 提供 min/max 两个参数;新增工具时可参照这个结构补充方法、描述和参数说明。
  • 需要配置项(API 密钥、服务端点、本地目录路径等)时,通过环境变量读取,并在 server.json 中用 environmentVariables 声明;需要命令行参数时用 packageArguments 声明。

5.2 接入业务的基本步骤

  1. 复制示例工具类结构,按业务域拆分工具方法。
  2. 补充参数校验、错误返回和必要的权限 / 上下文判断。
  3. 把外部依赖(数据库、内部 API、文件系统等)通过依赖注入接入 Program.cs。
  4. 在 server.json 中声明环境变量输入和发布参数。
  5. 用 Copilot Agent 或其他 MCP 客户端验证工具发现、参数传递和返回结果。

六、与 .NET AI 生态的配套关系

组件作用当前状态
Microsoft.Extensions.AI(MEAI)提供 IChatClient、IEmbeddingGenerator 等抽象,可用依赖注入、缓存、OpenTelemetry 组合模型访问;以 NuGet 包形式提供,不要求整体迁移框架版本可用
Microsoft Agent Framework(MAF)在 MEAI 抽象之上构建 Agent,负责工具调用、会话状态维护和多 Agent 工作流编排;可把 Agent 连接到 MCP 工具可用
AG-UI 托管集成通过 ASP.NET Core AG-UI 端点把 Agent 暴露出去,构建交互式 Blazor 体验预发布
Microsoft.AspNetCore.Components.AIBlazor 流式聊天、工具渲染、审批流程、共享 UI 状态等 Agentic UI 组件预发布,.NET 11 全程保持预发布

整体链路可以理解为:MCP 服务器模板负责把现有系统能力包装成标准工具,MEAI 负责对接模型调用,MAF 负责让 Agent 编排这些工具和业务流程,前端再通过 Blazor AI 组件或 AG-UI 端点承接交互。

七、打包发布到 NuGet

模板默认生成一个面向 .NET 支持的主流平台的自包含工具包,发布流程大致如下:

  1. 修改 .csproj 中的 ,保证在 NuGet.org 上唯一,例如 <用户名>.SampleMcpServer。
  2. 执行打包:dotnet pack -c Release,按项目中 列表生成工具包和多个特定平台包。
  3. 推送:dotnet nuget push bin/Release/*.nupkg --api-key --source https://api.nuget.org/v3/index.json;发布前测试可先推到 NuGet 集成环境 。
  4. 发布后在 NuGet.org 包详情的 MCP 服务器选项卡复制生成的 JSON,粘贴到 .vscode/mcp.json;通过 dnx 命令以工具方式运行(dnx 命令由 .NET 10 及以上 SDK 提供)。
  5. 含环境变量输入时,配置中的 inputs 会在客户端使用时提示填入对应值。

八、常见问题与注意事项

  • 找不到 dnx 命令:dnx 随 .NET 10 及以上 SDK 提供,需要安装匹配版本的 SDK,并在 PATH 中可用。
  • Copilot 没有调用自己的工具:先确认工具已在 VS Code 启用列表中;示例随机数工具可能因为模型内置了同类功能而不被主动选用,可以在提示中显式点名工具名(如 #get_random_number),并在 MCP 设置中确认服务器处于 Running 状态。
  • 模板选项与目标框架:虽然模板可选择 net8.0/net9.0 等旧框架,但 AI 相关 SDK 和工具链的兼容性需要单独核对;新项目建议直接用 net11.0。
  • Native AOT 与自包含:开启 --aot 后需要关注代码裁剪、反射和原生依赖兼容性;自包含发布会增大单包体积,但部署目标机器不需要预装运行时。
  • 安全边界:MCP 工具会被 AI Agent 调用,涉及文件读写、命令执行、内部接口访问的工具必须做参数校验、最小权限和审批控制,不要把高风险操作直接暴露给无约束的 Agent。
  • 预发布能力:AG-UI 托管集成和 Blazor AI 组件在 .NET 11 阶段仍是预发布,接口和行为可能随版本调整,生产采用前需评估稳定性。

九、.NET 11 其他可一并关注的更新

  • C# 15:联合类型和封闭层次结构,配合编译器检查的模式匹配表达应用状态。
  • SDK 工具链:默认启用 Native AOT CLI host,help、version 等命令可不启动托管 CLI;MSBuild server 默认保持预热,减少重复启动开销。
  • ASP.NET Core:异步校验、OpenAPI 3.2,以及 Blazor、SignalR 的新能力。
  • .NET MAUI:默认采用 CoreCLR 运行时,改进 XAML 迭代和原生控件。
  • 库与运行时:内置 Zstandard 压缩、更简单的进程执行、更丰富的 JSON 支持、免复制内存数据处理方式。
  • 开发工具:公开预览版 dotnetup 工具链管理器用于用户账号下安装更新 SDK 和运行时;MAUI DevFlow 工具包让 Agent 可以检查和测试运行中的应用 UI。

综合来看,.NET 11 内置 MCP 服务器模板降低了 .NET 生态接入 Agentic 开发的起步门槛:以前要装预览模板包才能起骨架,现在 SDK 自带项目、示例工具和 stdio/HTTP 两种传输选择,配合 MEAI、MAF 可以把企业已有 API 和内部系统逐步暴露成 AI 可调用的标准工具。后续落地重点不在模板本身,而在工具设计的粒度、参数与权限治理,以及把 MCP 服务纳入现有的部署、监控和安全体系。

【相关 FAQ】

问题 1:.NET 11 内置的 MCP 服务器模板怎么用,和之前的预览模板包有什么区别?

回答 1:装好 .NET 11 SDK 后直接执行 dotnet new mcpserver -o MyMcpServer 即可生成项目,模板随 SDK 内置,不再需要像 .NET 10 时代那样先 dotnet new install Microsoft.McpServer.ProjectTemplates 安装预览包。模板基于官方 MCP C SDK,自带 get_random_number 示例工具,生成 Program.cs、工具类、server.json 等文件,可直接接入 Copilot 等 MCP 客户端调试。

问题 2:.NET 11 的 MCP 服务器模板支持哪些传输方式,怎么选?

回答 2:模板提供 local(stdio)和 remote(http)两种传输类型,创建时通过模板选项选择。stdio 走标准输入输出,适合 IDE 内随本地进程启动的工具;http 走 HTTP 端点加 JSON-RPC,适合跨网络共享的远程服务。stdio 在 Program.cs 中用 .withStdioServerTransport() 配置,http 用 .withHttpServerTransport() 和 MapMcp(),并生成对应的主机配置文件。

问题 3:用 .NET 11 MCP 服务器模板生成的项目包含哪些文件,示例工具在哪里改?

回答 3:核心文件包括 Program.cs(注册传输类型和 MCP 工具)、RandomNumberTools.cs(get_random_number 示例工具,用 [McpServerTool] 标注)、HTTP 传输下的主机配置文件、server.json(发布元数据、环境变量和 CLI 参数声明)和 README。新增业务工具时参照 RandomNumberTools.cs 补充方法、参数和描述,环境配置通过环境变量读取并在 server.json 中声明。

问题 4:.NET 11 的 MCP 模板和 MEAI、MAF 之间是什么关系?

回答 4:MCP 服务器模板负责把企业自有能力暴露成标准 MCP 工具;Microsoft.Extensions.AI(MEAI)提供 IChatClient、IEmbeddingGenerator 等模型访问抽象;Microsoft Agent Framework(MAF)在 MEAI 之上编排 Agent 的工具调用、会话状态和工作流,并可把 Agent 连接到 MCP 工具。三者配合形成 "工具暴露 — 模型调用 —Agent 编排" 的完整链路,其中 AG-UI 托管集成和 Blazor AI 组件目前仍是预发布状态。

问题 5:发布 .NET 11 MCP 服务器到 NuGet 有哪些要点,容易踩什么坑?

回答 5:先用 dotnet pack -c Release 按 RuntimeIdentifiers 生成跨平台自包含工具包,再通过 dotnet nuget push 推送,注意 PackageId 必须唯一;发布后从 NuGet 包的 MCP 服务器选项卡复制配置 JSON,用 dnx 命令运行。容易踩的坑包括:未安装 .NET 10 及以上 SDK 导致找不到 dnx、开启 Native AOT 后反射或原生依赖不兼容、自包含包体积偏大,以及工具缺少参数校验和权限控制带来的 Agent 调用安全风险。

【参考资料】

[2026-11-10](Announcing .NET 11).NET Blog / Microsoft Developer Blogs

[2026-10-13](Use the NuGet MCP Server)Microsoft Learn

[2026-03-04](快速入门 - 创建最小 MCP 服务器并发布到 NuGet)Microsoft Learn

[2026-03-04](Quickstart: Create a minimal MCP server and publish to NuGet)Microsoft Learn

【免责声明】

本文基于微软官方 .NET 博客、Microsoft Learn 公开文档及公开技术资料整理,模板命令、选项、文件结构和组件状态可能随 .NET 后续更新、SDK 修订或文档版本调整而变化;预发布组件(AG-UI 托管集成、Blazor AI 组件等)的接口与行为以微软官方最新说明为准。文中示例命令和配置仅用于演示,实际项目开发请结合目标框架版本、SDK 安装情况、依赖兼容性和企业安全规范进行验证,本文不构成生产部署或技术选型的最终依据。

本文来自作者[亚簇推演]投稿,不代表江南网立场,如若转载,请注明出处:https://www.jnwb.net/xinwen/202611/2585.html

赞 (0)
反馈

发表回复

本站作者后才能评论

评论列表(4条)

  • 亚簇推演
    亚簇推演 2026年11月14日

    我是江南网的签约作者“亚簇推演”!

  • 亚簇推演
    亚簇推演 2026年11月14日

    希望本篇文章《.NET 11 正式发布SDK 内置 MCP 服务器模板,一条命令生成 stdio/HTTP 本地 MCP 服务》能对你有所帮助!

  • 亚簇推演
    亚簇推演 2026年11月14日

    本站[江南网]内容主要涵盖:互联网行业的追踪与探索

  • 亚簇推演
    亚簇推演 2026年11月14日

    本文概览:我先联网核实 NET 11 发布状态与内置 MCP 服务器模板的官方细节。微软已于 2026 年 11 月 10 日正式发布 NET 11,这版 SD

联系我们

联系:143 0457 151

工作时间:周一至周五,9:30-18:30,节假日休息

关注我们