MCP Quick Start

🧩 模型上下文协议（MCP）服务器 —— TypeScript 示例

基于TypeScript的 模型上下文协议（MCP） 用于测试本地工具、VS Code Copilot Chat 与大型语言模型（LLM）代理之间互操作性的服务器。\ 这个仓库用于追踪构建（某项目/系统）的进度 符合规范、安全、可观测且可投入生产的 MCP服务器实现。

______________________________________________________________________

🚀 概述

这个项目展示了：

• 一个最小的 MCP服务器 使用官方 @modelcontextprotocol/sdk 翻译为中文是：“@模型上下文协议/开发工具包”
• 两辆运输车：

- stdio 用于本地/编辑器集成 - Streamable HTTP 用于ChatGPT/Copilot Chat连接

• 两个例子：

- 工具： add – 执行加法运算 - 资源： greeting – 返回一条问候消息

______________________________________________________________________

🧰 快速入门

# install dependencies
npm install

# run in dev mode
npm run dev

# build + start production
npm run build && npm start

验证服务器

curl -s http://localhost:3000/healthz
# → OK

curl -s http://localhost:3000/mcp   -H "Content-Type: application/json"   -H "Accept: application/json, text/event-stream"   -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

______________________________________________________________________

🧩 与 VS Code 的集成（Copilot Chat）

1. 创建 .vscode/mcp.json

   {
     "servers": {
       "my-server": {
         "type": "http",
         "url": "http://localhost:3000/mcp"
       }
     },
     "defaultContexts": [
       { "server": "my-server" }
     ]
   }

1. 重新加载窗口\

你会看到的 my-server（MCP 服务器） 自动列在Copilot聊天中。

1. 在聊天中测试

   call add with { "a": 3, "b": 5 }

→ 应该返回您计算的结果。

______________________________________________________________________

🧠 核心目标与追踪

______________________________________________________________________

根据Zod模式自动生成API/工具文档。| ☐ 计划中 |

• 🧩 参考文献 模型上下文协议规范：
• modelcontextprotocol.io/文档（或“modelcontextprotocol.io/文档指南”） TypeScript SDK（软件开发工具包）：
• github.com/modelcontextprotocol/typescript-sdk 翻译为中文是：“github.com 上的 modelcontextprotocol/typescript-sdk 项目”。不过，通常我们不会直接翻译网址，而是直接使用原网址或在需要说明时简要提及。如果非要翻译整个表述，也可以是：“在 GitHub 上的 modelcontextprotocol 项目的 TypeScript SDK” Copilot Chat MCP 文档：

______________________________________________________________________

code.visualstudio.com/docs/copilot/customization/mcp-servers 的中文翻译是：“code.visualstudio.com 的文档：Copilot 自定义设置/多连接点服务器（MCP 服务器）”

🛠️ 当前状态

______________________________________________________________________

| 日志记录 | ☐ 结构化日志记录和指标待处理。 |

🧾 许可证

______________________________________________________________________

_麻省理工学院（MIT）_