MCP 服务器构建 系统化设计、实现、测试和部署 Model Context Protocol 服务器的方法论。 1. 协议核心概念 MCP 定义三种原语： - Tools（工具） ：AI 助手主动调用的函数，有副作用。如搜索、创建、删除操作。 - Resources（资源） ：AI 助手只读访问的数据源，用 URI 标识。如 。 - Prompts（提示词模板） ：预定义交互模板，引导用户触发工作流。 选择原则： 执行操作 → Tool | 读取数据 → Resource | 引导交互 → Prompt 2. 项目结构规范 TypeScript 关键依赖： + Python 关键依赖： + 3. Tool 设计原则 命名 - 格式，动词开头： 、 、 - 名称自解释，AI 助手靠名称选工具，模糊命名导致误调用 参数 - 每个参数有类型约束和 描述 - 可选参数给默认值，减少 AI 决策负担 - 用枚举代替布尔开关 描述 说明 用途 + 返回内容 + 限制 ，这是 AI 选择工具的关键依据： 输出 - 结构化数据 → JSON，人类可读内容 → Markdown - 始终用 格式返回 4. 输入验证和错误处理 用 Zod/Pydantic 做 Schema 级校验，业务级校验放 handler 开头： 错误处理四原则： 1. 永远不让服务器崩溃 — try/catch 包裹所有外…