GraphQL MCP 工具

一个模型上下文协议 (MCP) 服务器实现，提供 GraphQL API 交互能力。该服务器使 AI 助手能够通过一组标准化工具与 GraphQL API 进行交互。

组件

工具

• graphql_query

  • 针对任何端点执行 GraphQL 查询
  • 输入:
    • query (字符串): 要执行的 GraphQL 查询
    • variables (对象, 可选): 查询的变量
    • endpoint (字符串, 可选): GraphQL 端点 URL
    • headers (对象, 可选): 请求的 HTTP 标头
    • timeout (数字, 可选): 请求超时时间，以毫秒为单位
    • allowMutations (布尔值, 可选): 是否允许 mutation 操作

• graphql_introspect

  • 检索和探索 GraphQL 模式信息
  • 输入:
    • endpoint (字符串, 可选): GraphQL 端点 URL
    • headers (对象, 可选): 请求的 HTTP 标头
    • includeDeprecated (布尔值, 可选): 是否包含已弃用的类型/字段

与 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"
      ]
    }
  }
}

配置选项

服务器接受以下命令行参数：

• --endpoint (-e): 默认 GraphQL 端点 URL (默认: http://localhost:4000/graphql)
• --headers (-H): 所有请求的默认标头，以 JSON 字符串形式表示
• --timeout (-t): 默认请求超时时间，以毫秒为单位 (默认: 30000)
• --maxComplexity (-m): 允许的最大查询复杂度 (默认: 100)

许可证

此 MCP 服务器在 MIT 许可证下获得许可。 这意味着您可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。 有关更多详细信息，请参阅项目存储库中的 LICENSE 文件。