GraphQL MCP Tools

GraphQL MCP Tools

site icon
2025.03.30 4
JavaScriptGraphQL API 交互开发工具开发效率
mcp-graphql-tools 是一个基于 Model Context Protocol (MCP) 的服务实现,提供 GraphQL API 交互能力。该服务使 AI 助手能够通过一组标准化工具与 GraphQL API 进行交互。
View on GitHub

Overview

基本能力

产品定位

mcp-graphql-tools 是一个 GraphQL API 交互工具,旨在为 AI 助手提供与 GraphQL API 交互的能力。

核心功能

  1. graphql_query:执行 GraphQL 查询
  2. 支持自定义查询、变量、端点、请求头和超时设置
  3. 可选择是否允许突变操作
  4. graphql_introspect:检索和探索 GraphQL 模式信息
  5. 支持自定义端点和请求头
  6. 可选择是否包含已弃用的类型/字段

适用场景

  1. AI 助手与 GraphQL API 的交互
  2. GraphQL 模式信息的检索和探索
  3. 开发过程中的 GraphQL API 测试和调试

工具列表

  1. graphql_query
  2. 能力:执行 GraphQL 查询,支持自定义查询、变量、端点、请求头和超时设置
  3. graphql_introspect
  4. 能力:检索和探索 GraphQL 模式信息,支持自定义端点和请求头

常见问题解答

  1. 许可证:该 MCP 服务器采用 MIT 许可证,允许自由使用、修改和分发软件。

使用教程

使用依赖

  1. 确保已安装 Node.js 和 npm
  2. 确保已安装 npx

安装教程

  1. 通过 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"
      ]
    }
  }
}

调试方式

  1. 检查命令行参数是否正确
  2. 确保 GraphQL 端点可访问
  3. 检查请求头和令牌是否正确
  4. 检查超时和最大复杂度设置是否合理

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。