mcp4gql - GraphQL MCP Server

Name: mcp4gql - GraphQL MCP Server
Author: jorgeraad

本地服务

github.com/jorgeraad开发工具379 周前更新

代码仓库

关于 mcp4gql - GraphQL MCP Server

mcp4gql 是一个 Node.js/TypeScript MCP 服务，可将 GraphQL API 提供给 MCP 客户端调用，适合需要查询或执行变更操作的开发者。它还可通过 introspection 获取目标 API 的 schema。

主要功能

01获取 GraphQL schema
02执行 GraphQL 查询与 mutation
03支持 variables 和 operationName
04通过 stdio 与客户端通信
05可配置 Bearer token

适用场景

01检查目标 GraphQL API 的 schema
02从 MCP 客户端运行 GraphQL 查询
03通过 GraphQL mutation 执行 API 操作

MCP 相关

该 MCP 服务向客户端提供 schema introspection 和 GraphQL 操作执行工具，通过 stdio 传输。目标 GraphQL endpoint 与可选的 Bearer token 通过环境变量配置。

配置

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

mcp.json · 通用配置

{
  "mcpServers": {
    "mcp4gql": {
      "command": "npx",
      "args": [
        "-y",
        "mcp4gql"
      ],
      "env": {
        "GRAPHQL_ENDPOINT": "<GRAPHQL_ENDPOINT>",
        "AUTH_TOKEN": "<AUTH_TOKEN>"
      }
    }
  }
}

启动命令npx -y mcp4gql

需要配置的环境变量

GRAPHQL_ENDPOINT

AUTH_TOKEN密钥

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

安装包

npmmcp4gqlstdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

mcp4gql - GraphQL MCP 服务

mcp4gql

此项目是一个实现了 Model Context Protocol（MCP）的 Node.js/TypeScript 服务。它充当桥梁，让 MCP 客户端（如 Cursor）能够与目标 GraphQL API 交互。

功能

MCP 服务： 实现 @modelcontextprotocol/sdk 中的 MCP Server 类。
Stdio 传输： 通过标准输入/输出与客户端通信。
GraphQL 客户端： 使用 axios 向配置的 GraphQL 端点发送请求。
通用 GraphQL 工具： 向 MCP 客户端提供以下工具：
- introspectGraphQLSchema：通过内省获取目标 GraphQL API 的架构。
- executeGraphQLOperation：对目标 API 执行任意 GraphQL 查询或变更，输入包括 query、可选的 variables 和可选的 operationName。

配置

此服务需要以下环境变量：

GRAPHQL_ENDPOINT：目标 GraphQL API 的 URL。
AUTH_TOKEN：用于可选的 Authorization: Bearer <token> 标头的 Bearer 令牌，用于验证 GraphQL API 的访问身份。

客户端配置

若要让 Cursor 或 Claude Desktop 等客户端使用此服务提供的工具，需要将它们配置为运行 npx 命令。

Cursor

前往 Cursor MCP 设置（Cursor > Settings > Cursor Settings > MCP）
前往 + Add new global MCP server

将以下内容添加到 Cursor MCP 配置中：

{
  "mcpServers": {
    "mcp4gql": {
      "command": "npx",
      "type": "stdio",
      "args": ["-y", "mcp4gql"],
      "env": {
        "GRAPHQL_ENDPOINT": "YOUR_GRAPHQL_ENDPOINT_URL",
        "AUTH_TOKEN": "YOUR_OPTIONAL_AUTH_TOKEN"
      }
    }
  }
}

Claude Desktop

打开 Claude Desktop 设置（Claude > Settings）。
前往 Developer > Edit Config。

将以下内容添加到配置中：

{
  "mcpServers": {
    "mcp4gql": {
      "command": "npx",
      "args": ["-y", "mcp4gql"],
      "env": {
        "GRAPHQL_ENDPOINT": "YOUR_GRAPHQL_ENDPOINT_URL",
        "AUTH_TOKEN": "YOUR_OPTIONAL_AUTH_TOKEN"
      }
    }
  }
}

配置完成后，MCP 客户端应能在适用时列出并调用此服务提供的 introspectGraphQLSchema 和 executeGraphQLOperation 工具。请记得在配置中设置所需的环境变量（GRAPHQL_ENDPOINT 和可选的 AUTH_TOKEN），以便服务连接到你的 API。

支持 Markdown

登录后评论