GraphQL MCP 工具

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

组件

工具

• graphql_query

  • 对任意端点执行GraphQL查询
  • 输入参数：
    • query (字符串)：要执行的GraphQL查询
    • variables (对象，可选)：查询变量
    • endpoint (字符串，可选)：GraphQL端点URL
    • headers (对象，可选)：请求的HTTP头部
    • timeout (数字，可选)：请求超时时间（毫秒）
    • allowMutations (布尔值，可选)：是否允许变更操作

• 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文件。 </中文翻译>