
GraphQL MCP Tools

2025.03.30
4
JavaScriptGraphQL API 交互开发工具开发效率
mcp-graphql-tools 是一个基于 Model Context Protocol (MCP) 的服务实现,提供 GraphQL API 交互能力。该服务使 AI 助手能够通过一组标准化工具与 GraphQL API 进行交互。
View on GitHub
Overview
基本能力
产品定位
mcp-graphql-tools 是一个 GraphQL API 交互工具,旨在为 AI 助手提供与 GraphQL API 交互的能力。
核心功能
- graphql_query:执行 GraphQL 查询
- 支持自定义查询、变量、端点、请求头和超时设置
- 可选择是否允许突变操作
- graphql_introspect:检索和探索 GraphQL 模式信息
- 支持自定义端点和请求头
- 可选择是否包含已弃用的类型/字段
适用场景
- AI 助手与 GraphQL API 的交互
- GraphQL 模式信息的检索和探索
- 开发过程中的 GraphQL API 测试和调试
工具列表
- graphql_query
- 能力:执行 GraphQL 查询,支持自定义查询、变量、端点、请求头和超时设置
- graphql_introspect
- 能力:检索和探索 GraphQL 模式信息,支持自定义端点和请求头
常见问题解答
- 许可证:该 MCP 服务器采用 MIT 许可证,允许自由使用、修改和分发软件。
使用教程
使用依赖
- 确保已安装 Node.js 和 npm
- 确保已安装 npx
安装教程
- 通过 npx 直接运行:
{
"mcpServers": {
"graphql": {
"command": "npx",
"args": [
"-y",
"mcp-graphql-tools",
"--endpoint=https://api.github.com/graphql",
"--headers={\"Authorization\":\"Bearer YOUR_GITHUB_TOKEN\"}",
"--timeout=30000",
"--maxComplexity=100"
]
}
}
}
调试方式
- 检查命令行参数是否正确
- 确保 GraphQL 端点可访问
- 检查请求头和令牌是否正确
- 检查超时和最大复杂度设置是否合理