MCP GraphQL

基本能力

产品定位

graphql-mcp 是一个用于与 GraphQL API 交互的 MCP 服务器，主要用于开发者在开发过程中动态调用和探索 GraphQL 操作。

核心功能

• 调用 GraphQL 操作：动态执行查询和变更。
• 列出查询和变更：检索 GraphQL 模式中所有可用的查询和变更。
• 描述模式实体：获取关于 GraphQL 操作和类型的详细信息。
• 设置自定义头：配置和管理 API 调用的认证或请求头。

适用场景

• 开发者在开发过程中需要动态调用 GraphQL API。
• 需要快速探索和了解 GraphQL 模式的可用操作和类型。
• 需要为 GraphQL 请求设置自定义头（如认证头）。

工具列表

• invoke_graphql：执行 GraphQL 操作（查询或变更）。
• list_queries：检索 GraphQL 模式中所有可用的查询。
• list_mutations：检索 GraphQL 模式中所有可用的变更。
• describe：获取指定 GraphQL 操作或类型的详细信息。
• set_headers：设置或覆盖 GraphQL 请求的 HTTP 头。

常见问题解答

无

使用教程

使用依赖

• Go 1.23.0 或更高版本
• 运行的 GraphQL API

安装教程

1. 安装包

go install github.com/wricardo/mcp-graphql@latest

1. 配置环境变量

export ADDRESS="https://your-graphql-endpoint.com"

1. 配置 MCP 客户端设置

"mcp-graphql": {
  "command": "mcp-graphql",
  "env": {
    "ADDRESS": "https://your-graphql-endpoint.com"
  },
  "disabled": false,
  "autoApprove": []
}

调试方式

运行 MCP 服务器

mcp-graphql

许可证

None