什么是 MCP?
Model Context Protocol (MCP) 是 Anthropic 推出的开放标准,用于将 AI 助手连接到外部数据源和工具。可以将其视为 AI 的 USB-C——一种到处通用的协议。
为什么 MCP 重要
在 MCP 之前,每个 AI 集成都是定制的。每个工具需要自己的插件、API 包装器和配置。MCP 标准化了这一切。
架构
- MCP 宿主:AI 应用(如 Claude Desktop、Cursor)。
- MCP 服务器:通过协议暴露工具和数据。
- MCP 客户端:将宿主连接到服务器。
核心概念
- 工具:AI 可调用的函数(搜索、创建文件、查询数据库)。
- 资源:AI 可读取的数据(文件、数据库记录、API 响应)。
- 提示词:应用间共享的可复用提示模板。
构建 MCP 服务器
1. 用 JSON schema 定义工具。
2. 实现 MCP 协议(REST 或 stdio 传输)。
3. 注册能力(工具、资源、提示词)。
4. 用 MCP Inspector 或 Claude Desktop 测试。
生态系统
- GitHub:仓库和 Issue 的 MCP 服务器。
- PostgreSQL:数据库查询的 MCP 服务器。
- Slack:消息和频道的 MCP 服务器。
- 文件系统:本地文件访问的 MCP 服务器。
开发者指南
- TypeScript 和 Python SDK 可用。
- 规范见 modelcontextprotocol.io。
- 社区服务器快速增长——已有数百个。
构建你的第一个 MCP 服务器
使用 TypeScript SDK 的最小示例:定义服务器、注册工具、处理请求。
旧写法虽仍存在但已弃用,当前应使用 registerTool 作为入口:
- `npm install @modelcontextprotocol/sdk zod`
- `import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";`
- `import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";`
- `const server = new McpServer({ name: "my-tool", version: "1.0.0" });`
- `server.registerTool("search", { inputSchema: { query: z.string() } }, async ({ query }) => ({ content: [{ type: "text", text: JSON.stringify(await searchDatabase(query)) }] }));`
- `await server.connect(new StdioServerTransport());`
来源:npm 上的 @modelcontextprotocol/sdk 包,版本 1.32.2,2026-11-10 核对。此前正文引用的 @mcp/sdk 在 npm 上并不存在。
安全考虑
- 认证:MCP 服务器应要求 API 密钥或 OAuth token。永远不要公开暴露无认证的服务器。
- 输入验证:根据 schema 验证所有工具输入。MCP 不会自动净化输入。
- 速率限制:实施速率限制防止滥用。典型限制为每客户端 100 请求/分钟。
- 审计日志:记录所有工具调用以进行调试和合规。
MCP vs 传统 API
MCP 增加了语义理解——AI 知道每个工具的功能和使用时机。与 REST API 中开发者硬编码集成逻辑不同,MCP 让 AI 根据上下文决定调用哪些工具。这使 MCP 非常适合 AI 需要动态选择操作的 Agent 工作流。
集成面就是工具 schema
大家评估 MCP 时常常比较传输方式,却忘了其他系统真正依赖的部分是工具定义:名字、描述、参数与结果的结构。描述含糊的工具会在错误的时机被每个客户端调用,返回非结构化散文的结果无法与下游任何东西组合。把力气花在 schema 和描述上,因为传输是已解决的问题,而接口不是。
描述就是提示词。要为「模型正在判断到底要不要调这个工具」而写,包括什么时候不该调。把参数命名写清楚比缩写重要得多,而返回一个小的带类型对象,永远胜过返回一段文字。
本地服务端是摩擦力最小的起点
跑在用户自己机器上的 stdio 服务端一次性避开最难的问题:不用托管、不用鉴权基础设施,而且有天然的信任边界,因为进程以用户的权限、在用户的数据上运行。从这里开始。只有当能力确实需要跨机器或跨用户共享时,才转向远程 HTTP 服务端,并接受那时你就得自己负责认证、授权和多租户。
集成在实践中会在哪里断
会往 stdout 写东西的服务端。在 stdio 上,stdout 就是协议通道,一句多余的 print 就会破坏数据流,而失败看起来像客户端 bug。日志写到 stderr,并用「启动服务端、盯着有没有非 JSON 字节」来测试。这一个检查能省下几小时让人困惑的调试。
一个合理的第一版服务端
包一个你已有的内部工具,用精确的 schema 和诚实的描述暴露它,自己先用一周,再发给别人。