JinDaGe - graphql MCP Details

article

README

🚀 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 文件。

graphql