关于 Aspire.MCP.Sample
Aspire.MCP.Sample 是一个基于 .NET Aspire 编排的 MCP(Model Context Protocol)服务示例。它把 MCP Server、工具实现与 AI 客户端组装成一个个独立的“乐高积木”,通过 Aspire 的 AppHost 一键拉起、可视化调试,让你在本地就能跑通一个完整的 AI 对话 Demo。
- 能接什么:任何兼容 MCP 协议的客户端(如支持 MCP 的 IDE、AI Agent 桌面工具、VS Code Copilot 等)都可以通过 stdio 或配置的端点连接;服务端则通过 Aspire 注入的
IChatClient与大模型对接,可灵活替换 OpenAI、Azure OpenAI、Ollama 等后端。 - 典型场景:快速验证 MCP 工具调用流程、本地调试自定义工具(Tools / Resources / Prompts)、学习 Aspire 的服务编排与服务发现机制。
- 是否需要密钥:示例本身不内置任何 Token。运行前需要你自行配置大模型提供方的 API Key(最常见的是通过
appsettings.Development.json或环境变量OPENAI_API_KEY/AZURE_OPENAI_API_KEY等注入),请勿把真实密钥提交到代码仓库。 - 上手门槛:需要 .NET 9 SDK 与 Aspire 工作负载(
dotnet workload install aspire),克隆后aspire run即可在仪表盘中看到所有组件并交互测试。
简而言之,这是一个“用 Aspire 把 MCP 服务像乐高一样拼起来”的最小可运行范例,适合用来学习协议、改造为内部工具桥接,或作为复杂 Agent 系统的本地脚手架。