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

准备文档

在开始之前,收集必要的文档以帮助 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 检查器工具测试服务器
  3. 将其连接到 Claude.app 或其他 MCP 客户端
  4. 根据实际使用情况和反馈进行迭代

请记住,随着需求的改变,Claude 可以帮助您修改和改进服务器。

需要更多指导?只需向 Claude 提出有关实现 MCP 功能或解决出现问题的具体问题。