使用 LLM 构建 MCP
使用 Claude 等 LLM 加速您的 MCP 开发!
本指南将帮助您使用 LLM 来帮助您构建自定义模型上下文协议 (MCP) 服务器和客户端。在本教程中,我们将重点介绍 Claude,但您可以使用任何前沿 LLM 执行此作。
一、准备文档
在开始之前,请收集必要的文档以帮助 Claude 了解 MCP:
- 访问 https://modelcontextprotocol.io/llms-full.txt 并复制完整的文档文本
- 导航到 MCP TypeScript SDK 或 Python SDK 存储库
- 复制 README 文件和其他相关文档
- 将这些文档粘贴到您与 Claude 的对话中
《模型上下文协议中文网》附注:
但由于Claude的注册制目前对大陆是完全封禁的。其他LLM大概率处理不了llms-full.txt 这么几万字长的文档,实际上也没必要。你直接绕过这一步即可。
虽然目前只有Claude是完全实现了协议,但并不意味着不能做完整测试,服务端只需要关注三个核心概念(资源
、工具
、提示
)即可。
二、描述您的服务器
提供文档后,请向 Claude 清楚地描述您要构建哪种服务器。具体说明:
- 您的服务器将公开哪些资源
- 它将提供什么工具
- 它应该提供的任何提示
- 它需要与哪些外部系统交互
例如:
markdown
构建一个 MCP 服务器,要求如下:
- 连接到我公司使用的 PostgreSQL 数据库
- 将数据库表结构作为资源暴露出来
- 提供工具来执行只读 SQL 查询
- 包含用于常见数据分析任务的预设提示
- 使用javaScript语言 (补充)
《模型上下文协议中文网》附注:
官方文档提醒你,没必要先学习具体语言的SDK,从第一行代码开始,而是将你的设计文档丢给AI,请求明确的告知AI关键的边界,那么,AI可以自动替你生成一个样板代码,你再针对性去理解、调整、扩展。
从架构设计上说,一般而言,真正的业务逻辑不应该写死在MCP服务中。MCP服务更像是一个适配层,大多数的通用逻辑被都SDK包揽了,所以MCP服务代码并不多。
三、与 Claude 合作
在 Claude上使用MCP服务器时:
- 首先从核心功能开始,然后迭代以添加更多功能
- 请 Claude 解释您不理解的代码部分
- 根据需要请求修改或改进
- 让 Claude 帮助您测试服务器并处理边缘情况
Claude 可以帮助实现所有关键的 MCP 功能:
- 资源管理和曝光
- 工具定义和实现
- 提示模板和处理程序
- 错误处理和日志记录
- 连接和传输设置
其他
《模型上下文协议中文网》附注:下面部分新手可先不关注
1、最佳实践
使用 Claude 构建 MCP 服务器时:
- 将复杂的服务器分解成更小的部分
- 在继续之前,请彻底测试每个组件
- 牢记安全性 - 验证输入并适当限制访问
- 妥善记录您的代码以备将来维护
- 仔细遵循 MCP 协议规范
2、后续步骤
在 Claude 帮助您构建服务器之后:
- 仔细查看生成的代码
- 使用 MCP Inspector 工具测试服务器
- 将其连接到 Claude.app 或其他 MCP 客户端
- 根据实际使用情况和反馈进行迭代
请记住,Claude 可以帮助您根据需求随时间的变化修改和改进您的服务器。
需要更多指导?只需向 Claude 询问有关实施 MCP 功能或解决出现的问题的具体问题即可。