🚀 GraphQL MCP 工具服务器

GraphQL MCP 工具服务器是一个实现了 Model Context Protocol (MCP) 的服务器，它提供了 GraphQL API 交互能力。借助该服务器，AI 助手能够通过一组标准化工具与 GraphQL API 进行交互。

🚀 快速开始

本服务器可让 AI 助手与 GraphQL API 进行标准化交互，为 AI 应用提供了强大的支持。

✨ 主要特性

• 提供标准化工具，便于 AI 助手与 GraphQL API 交互。
• 支持多种 GraphQL 操作，如查询和模式探索。

📦 安装指南

暂未提及具体安装步骤，可根据后续需求补充。

💻 使用示例

基础用法

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