本指南将帮助你使用 LLMs 来构建自定义的模型上下文协议(Model Context Protocol,MCP)服务器和客户端。本教程将以 Claude 为例进行讲解,但你可以使用任何前沿的 LLM 来完成这项工作。

准备文档

在开始之前,收集必要的文档来帮助 Claude 理解 MCP:

  1. 访问 https://modelcontextprotocol.io/llms-full.txt 并复制完整的文档文本
  2. 访问 MCP TypeScript SDKPython SDK 代码库
  3. 复制 README 文件和其他相关文档
  4. 将这些文档粘贴到你与 Claude 的对话中

描述你的服务器

在提供完文档后,向 Claude 清晰地描述你想要构建的服务器类型。具体说明:

  • 你的服务器将暴露哪些资源
  • 它将提供哪些工具
  • 它应该提供哪些提示
  • 它需要与哪些外部系统交互

例如:

构建一个 MCP 服务器,它将:
- 连接到公司的 PostgreSQL 数据库
- 将表结构暴露为资源
- 提供用于执行只读 SQL 查询的工具
- 包含常见数据分析任务的提示

与 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 功能或解决出现的问题的具体问题。