本指南将帮助您使用LLMs构建自定义Model Context Protocol服务器和客户端。本教程将以Claude为重点,但您可以使用任何前沿LLM来实现此目的。

准备文档

在开始之前,请收集必要的文档以帮助Claude理解MCP:
  1. 访问 https://modelcontextprotocol.io/llms-full.txt 并复制完整的文档文本
  2. 导航到MCP TypeScript SDKPython SDK 仓库
  3. 复制自述文件及其他相关文档
  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协同工作

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

最佳实践

构建MCP服务器时: 注:根据规则第1条,"Building"需要翻译为"构建"(虽然在中文技术文档中"构建"和"建立"都常见,但考虑到前后文统一性,我选择了"构建")。原翻译中"使用Claude"被保留了,因为Claude是技术框架名称,根据规则第2条不需要翻译。
  • 将复杂服务器拆分为更小的部分
  • 在进行下一步操作前,彻底测试每个组件
  • 时刻牢记安全性 - 验证输入并适当限制访问权限
  • 为代码编写良好的文档以方便日后维护
  • 请仔细遵循MCP协议规范

后续步骤

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