本指南将帮助你使用 LLM 来构建自定义模型上下文协议 (MCP) 服务器和客户端。本教程将重点介绍 Claude,但你也可以使用任何前沿的 LLM 来完成此操作。

准备文档

开始之前,请收集必要的文档以帮助 Claude 理解 MCP
  1. 访问 https://modelcontextprotocol.net.cn/llms-full.txt 并复制完整的文档文本
  2. 前往 MCP TypeScript SDKPython SDK 代码库
  3. 复制 README 文件和其他相关文档
  4. 将这些文档粘贴到你与 Claude 的对话中

描述你的服务器

提供文档后,向 Claude 清晰地描述你想要构建的服务器类型。请具体说明:
  • 你的服务器将公开哪些资源
  • 它将提供哪些工具
  • 它应该提供哪些提示
  • 它需要与哪些外部系统交互
例如
Build an MCP server that:
- Connects to my company's PostgreSQL database
- Exposes table schemas as resources
- Provides tools for running read-only SQL queries
- Includes prompts for common data analysis tasks

与 Claude 协作

与 Claude 协作开发 MCP 服务器时
  1. 首先从核心功能开始,然后迭代添加更多功能
  2. 让 Claude 解释你代码中不理解的任何部分
  3. 根据需要请求修改或改进
  4. 让 Claude 帮助你测试服务器并处理边缘情况
Claude 可以帮助实现所有关键的 MCP 功能
  • 资源管理和公开
  • 工具定义和实现
  • 提示模板和处理程序
  • 错误处理和日志记录
  • 连接和传输设置

最佳实践

使用 Claude 构建 MCP 服务器时
  • 将复杂的服务器分解成更小的部分
  • 在进入下一步之前,彻底测试每个组件
  • 牢记安全 - 验证输入并适当地限制访问
  • 为未来的维护做好代码文档记录
  • 仔细遵循 MCP 协议规范

后续步骤

在 Claude 帮助你构建服务器之后
  1. 仔细审查生成的代码
  2. 使用 MCP Inspector 工具测试服务器
  3. 将其连接到 Claude.app 或其他 MCP 客户端
  4. 根据实际使用情况和反馈进行迭代
请记住,随着需求随时间变化,Claude 可以帮助你修改和改进你的服务器。需要更多指导?只需向 Claude 提出关于实现 MCP 功能或解决出现问题的具体问题。