GraphQL API交互工具

GraphQL MCP工具

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

组件

工具

• graphql_query

  • 对任何端点执行GraphQL查询
  • 输入：
    • query （string）：要执行的GraphQL查询
    • variables （object，可选）：查询的变量
    • endpoint （字符串，可选）：GraphQL端点URL
    • headers （object，可选）：请求的HTTP标头
    • timeout （数字，可选）：请求超时（毫秒）
    • allowMutations （boolean，可选）：是否允许变异操作

• graphql_introspect

  • 检索和探索GraphQL模式信息
  • 输入：
    • endpoint （字符串，可选）：GraphQL端点URL
    • headers （object，可选）：请求的HTTP标头
    • includeDeprecated （boolean，可选）：是否包含弃用的类型/字段

使用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文件。