Graphql

Name: Graphql
Author: saewoohan

本地服务

github.com/saewoohan开发工具882 周前更新

代码仓库

关于 Graphql

Graphql 是供 AI 助手与 GraphQL API 交互的 MCP 服务，提供查询执行和架构自省，并可配置请求参数及是否允许 mutation。

主要功能

01执行 GraphQL 查询
02传入变量、请求头和端点
03检查 GraphQL 架构
04按需允许 mutation 操作

适用场景

01查询 GraphQL API 数据
02探索可用的架构类型和字段

MCP 相关

它向 MCP 客户端提供查询执行和架构自省工具。

#graphql #api #mcp-tools

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "graphql-tools": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-graphql-tools"
      ]
    }
  }
}

启动命令npx -y mcp-graphql-tools

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmmcp-graphql-toolsstdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
endpoint	string	否	GraphQL 端点 URL（可省略以使用默认值）
query	string	是	要执行的 GraphQL 查询
variables	object	否	与查询搭配使用的变量（JSON 对象）
headers	object	否	请求中要包含的额外标头（将与默认标头合并）
timeout	number	否	请求超时时间，单位为毫秒

详细介绍

GraphQL MCP 工具

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

组件

工具

graphql_query
- 对任意端点执行 GraphQL 查询
- 输入：
  - query（string）：要执行的 GraphQL 查询
  - variables（object，可选）：查询变量
  - endpoint（string，可选）：GraphQL 端点 URL
  - headers（object，可选）：请求的 HTTP 标头
  - timeout（number，可选）：请求超时时间，单位为毫秒
  - allowMutations（boolean，可选）：是否允许 mutation 操作
graphql_introspect
- 获取并探索 GraphQL 架构信息
- 输入：
  - endpoint（string，可选）：GraphQL 端点 URL
  - headers（object，可选）：请求的 HTTP 标头
  - includeDeprecated（boolean，可选）：是否包含已弃用的类型/字段

在 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"
      ]
    }
  }
}