Skip to content

使用 LLM 构建 MCP

使用 Claude 等 LLM 加速您的 MCP 开发!

本指南将帮助您使用 LLM 来帮助您构建自定义模型上下文协议 (MCP) 服务器和客户端。在本教程中,我们将重点介绍 Claude,但您可以使用任何前沿 LLM 执行此作。

一、准备文档

在开始之前,请收集必要的文档以帮助 Claude 了解 MCP:

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

《模型上下文协议中文网》附注:

但由于Claude的注册制目前对大陆是完全封禁的。其他LLM大概率处理不了llms-full.txt 这么几万字长的文档,实际上也没必要。你直接绕过这一步即可。

虽然目前只有Claude是完全实现了协议,但并不意味着不能做完整测试,服务端只需要关注三个核心概念(资源工具提示)即可。

二、描述您的服务器

提供文档后,请向 Claude 清楚地描述您要构建哪种服务器。具体说明:

  • 您的服务器将公开哪些资源
  • 它将提供什么工具
  • 它应该提供的任何提示
  • 它需要与哪些外部系统交互

例如:

markdown
构建一个 MCP 服务器,要求如下:
- 连接到我公司使用的 PostgreSQL 数据库
- 将数据库表结构作为资源暴露出来
- 提供工具来执行只读 SQL 查询
- 包含用于常见数据分析任务的预设提示
- 使用javaScript语言   (补充)

《模型上下文协议中文网》附注:

官方文档提醒你,没必要先学习具体语言的SDK,从第一行代码开始,而是将你的设计文档丢给AI,请求明确的告知AI关键的边界,那么,AI可以自动替你生成一个样板代码,你再针对性去理解、调整、扩展。

从架构设计上说,一般而言,真正的业务逻辑不应该写死在MCP服务中。MCP服务更像是一个适配层,大多数的通用逻辑被都SDK包揽了,所以MCP服务代码并不多。

三、与 Claude 合作

在 Claude上使用MCP服务器时:

  1. 首先从核心功能开始,然后迭代以添加更多功能
  2. 请 Claude 解释您不理解的代码部分
  3. 根据需要请求修改或改进
  4. 让 Claude 帮助您测试服务器并处理边缘情况

Claude 可以帮助实现所有关键的 MCP 功能:

  • 资源管理和曝光
  • 工具定义和实现
  • 提示模板和处理程序
  • 错误处理和日志记录
  • 连接和传输设置

其他

《模型上下文协议中文网》附注:下面部分新手可先不关注

1、最佳实践

使用 Claude 构建 MCP 服务器时:

  • 将复杂的服务器分解成更小的部分
  • 在继续之前,请彻底测试每个组件
  • 牢记安全性 - 验证输入并适当限制访问
  • 妥善记录您的代码以备将来维护
  • 仔细遵循 MCP 协议规范

2、后续步骤

在 Claude 帮助您构建服务器之后:

  1. 仔细查看生成的代码
  2. 使用 MCP Inspector 工具测试服务器
  3. 将其连接到 Claude.app 或其他 MCP 客户端
  4. 根据实际使用情况和反馈进行迭代

请记住,Claude 可以帮助您根据需求随时间的变化修改和改进您的服务器。

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