🚀 GraphQL MCP 工具服务器
GraphQL MCP 工具服务器是一个实现了 Model Context Protocol (MCP) 的服务器，它提供了 GraphQL API 交互能力。借助该服务器，AI 助手能够通过一组标准化工具与 GraphQL API 进行交互。
✨ 主要特性
- 提供标准化工具，让 AI 助手可与 GraphQL API 交互。
- 包含多种工具，能执行查询、探索模式信息。
📦 安装指南
文档中未提及安装步骤，暂不提供相关内容。
💻 使用示例
基础用法
以下是使用 Claude Desktop 时的 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_query
- 功能：执行任意端点的 GraphQL 查询。
- 输入：
query(字符串)：要执行的 GraphQL 查询。variables(对象, 可选)：查询变量。endpoint(字符串, 可选)：GraphQL 端点 URL。headers(对象, 可选)：请求的 HTTP 头部。timeout(数字, 可选)：请求超时时间（以毫秒为单位）。allowMutations(布尔值, 可选)：是否允许突变操作。
graphql_introspect
- 功能：获取并探索 GraphQL 模式信息。
- 输入：
endpoint(字符串, 可选)：GraphQL 端点 URL。headers(对象, 可选)：请求的 HTTP 头部。includeDeprecated(布尔值, 可选)：是否包含已弃用的类型/字段。
配置选项
该服务器接受以下命令行参数：
--endpoint(-e)：默认 GraphQL 端点 URL (默认: http://localhost:4000/graphql)。--headers(-H)：所有请求的默认头部（以 JSON 格式）。--timeout(-t)：请求超时时间（以毫秒为单位，默认: 30000）。--maxComplexity(-m)：最大允许查询复杂度 (默认: 100)。
📄 许可证
此 MCP 服务器根据 MIT License 分发。这意味着您可以自由使用、修改和分发软件，但需遵守 MIT License 的条款和条件。有关详细信息，请参阅项目存储库中的 LICENSE 文件。