摘要
将任何 GraphQL API 连接到模型上下文协议。让 AI 代理通过 GraphQL 端点查询和修改数据，使用 AnythingMCP。
GraphQL 和 MCP：自然的契合
GraphQL 的类型化模式和自文档化特性使其成为 MCP 工具生成的理想来源。AnythingMCP 利用 GraphQL 反射自动从你的查询和变更中创建良好类型的 MCP 工具。
为什么将 GraphQL 转换为 MCP？
虽然 GraphQL 对开发者来说非常强大，但 AI 代理需要 MCP 协议来与工具交互。通过将 GraphQL 转换为 MCP，你可以让 AI 代理：
- 使用自然语言查询数据，而不是编写 GraphQL 查询
- 安全地执行变更，并使用经过验证的参数
- 导航关系，而无需理解图遍历
分步指南
第一步：部署 AnythingMCP
克隆代码库并使用 Docker Compose 启动应用程序：
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
这将启动 PostgreSQL、后端 API（端口 4000）和仪表板（端口 3000）。
第二步：创建 GraphQL 连接器
在 http://localhost:3000 打开 AnythingMCP 仪表板并创建一个新的 GraphQL 连接器。提供 GraphQL 端点 URL — AnythingMCP 将使用 反射 自动发现完整模式，包括所有查询、变更和类型。
第三步：模式反射
AnythingMCP 自动反射你的 GraphQL 模式并生成 MCP 工具：
- 查询 变为只读的 MCP 工具
- 变更 变为可写的 MCP 工具
- 输入类型 变为具有适当验证的工具参数
- 枚举类型 变为参数约束
第四步：配置身份验证
在连接器设置中，为你的 GraphQL API 配置身份验证。AnythingMCP 支持 Bearer 令牌、API 密钥和自定义头部。可以使用环境变量来存储密钥。
第五步：自定义和测试
在仪表板中，查看每个生成的工具，自定义名称和描述，并选择要公开的操作。使用内置测试界面执行操作并验证响应。
第六步：连接到 AI 代理
配置你的 MCP 客户端以连接到 AnythingMCP 服务器：
{
"mcpServers": {
"my-graphql-api": {
"url": "http://localhost:4000/mcp"
}
}
}
常见的 GraphQL API 连接
| 服务 | 用例 |
|---|---|
| GitHub | 存储库和问题管理 |
| Shopify | 电子商务操作 |
| Hasura | 数据库访问 |
| Contentful | 内容管理 |
| Strapi | 无头 CMS |
最佳实践
- 启用反射 — 确保你的 GraphQL 端点允许反射查询
- 从查询开始 — 首先公开读取操作，然后添加变更
- 简化嵌套响应 — 自定义工具响应中包含的字段
- 速率限制 — 配置速率限制以避免对 GraphQL 服务器造成过大压力
下一步
- REST 到 MCP 指南 — 转换 REST API
- 数据库到 MCP 指南 — 直接数据库访问
这份指南对你有帮助吗?
