写 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

评论区

0 条评论

登录后可评论。

江望 14 阅读