写 MCP 服务端?先看看这个工程模式手册
如果你在搞 AI 应用开发,十有八九绕不开一个问题:怎么让大模型调用你的工具? MCP(Model Context Protocol)就是干这个的——它是大模型和外部工具之间的”连接器”,Anthropic、OpenAI、Google 这些大厂都在推。
但现实问题是:MCP 服务端怎么写? 用什么 SDK?工具怎么注册?传输层用 stdio 还是 HTTP?这些细节官方文档写得很散,真上手的时候一堆问号。
今天挖到一个 Skill——mcp-server-patterns,来自 ECC 项目(一个工程实践代码库),专门解决这个问题。
这个 Skill 解决什么问题
它不是一个”帮你写代码”的 Skill,而是一个工程模式参考手册。当你需要写一个 MCP 服务端的时候,它告诉你:
- 工具(Tools)、资源(Resources)、提示(Prompts)怎么注册
- Schema 怎么定义(推荐用 Zod 做输入校验)
- 传输层怎么选:本地客户端用 stdio,远程客户端用 Streamable HTTP
- SDK 版本变化导致的 API 差异怎么处理
简单说就是你写 MCP 服务器时的查表手册,比翻官方文档效率高多了。
核心用法
以最常见的 Node/TypeScript 为例,安装只需一行:
npm install @modelcontextprotocol/sdk zod
然后是标准套路:
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { z } from "zod";
const server = new McpServer({ name: "my-server", version: "1.0.0" });
// 注册工具,Zod 做输入校验
server.tool("search", "Search something", {
query: z.string()
}, async ({ query }) => {
// 实际逻辑
return { result: `Found: ${query}` };
});
传输层方面,本地 CLI 场景用 stdio,云服务/远程场景用 Streamable HTTP。Skill 里的决策树帮你选对。
为什么值得关注
MCP 正在成为 AI 工具调用的事实标准。Cursor、Copilot、Claude Desktop 都在支持。但目前社区最缺的不是”怎么用”,而是怎么正确实现一个生产级 MCP 服务端——这个 Skill 正是填补这个空白的。
它不教你理论,直接给你工程实践中验证过的模式。遇到具体问题,直接查,比 AI 搜索更准。
作者是 affaan-m,ECC 项目维护者,这个项目专注”企业级工程实践”,代码质量在圈内口碑不错。
快速安装
npx skills add https://github.com/affaan-m/ECC --skill mcp-server-patterns
或者直接去 GitHub 看源文件:
https://github.com/affaan-m/ECC/tree/main/skills/mcp-server-patterns
GitHub: https://github.com/affaan-m/ECC/tree/main/skills/mcp-server-patterns
评论区
登录后可评论。