mcp-graphql

一个模型上下文协议（Model Context Protocol）服务器，使 LLM 能够与 GraphQL API 交互。此实现提供模式内省和查询执行功能，允许模型动态发现和使用 GraphQL API。

用法

使用正确的端点运行 mcp-graphql，它将自动尝试内省您的查询。

命令行参数

参数	描述	默认值
--endpoint	GraphQL 端点 URL	http://localhost:4000/graphql
--headers	包含请求标头的 JSON 字符串	{}
--enable-mutations	启用 mutation 操作（默认禁用）	false
--name	MCP 服务器的名称	mcp-graphql
--schema	本地 GraphQL 模式文件的路径（可选）	-

示例

# 基本用法，使用本地 GraphQL 服务器
npx mcp-graphql --endpoint http://localhost:3000/graphql

# 使用自定义标头
npx mcp-graphql --endpoint https://api.example.com/graphql --headers '{"Authorization":"Bearer token123"}'

# 启用 mutation 操作
npx mcp-graphql --endpoint http://localhost:3000/graphql --enable-mutations

# 使用本地模式文件而不是内省
npx mcp-graphql --endpoint http://localhost:3000/graphql --schema ./schema.graphql

可用工具

该服务器提供两个主要工具：

1. introspect-schema: 此工具检索 GraphQL 模式。如果您无法以资源形式访问该模式，请首先使用此工具。 这使用本地模式文件或内省查询。

2. query-graphql: 针对端点执行 GraphQL 查询。 默认情况下，除非指定 --enable-mutations，否则 mutation 将被禁用。

资源

• graphql-schema: 服务器将 GraphQL 模式公开为客户端可以访问的资源。 这是本地模式文件或基于内省查询。

安装

通过 Smithery 安装

要通过 Smithery 为 Claude Desktop 自动安装 GraphQL MCP 工具包：

npx -y @smithery/cli install mcp-graphql --client claude

手动安装

可以手动安装到 Claude：

{
  "mcpServers": {
    "mcp-graphql": {
      "command": "npx",
      "args": ["mcp-graphql", "--endpoint", "http://localhost:3000/graphql"]
    }
  }
}

安全注意事项

默认情况下禁用 Mutation，这是一种安全措施，可防止 LLM 修改您的数据库或服务数据。 在生产环境中启用 mutation 之前，请仔细考虑。

为您自己的服务器定制

这是一个非常通用的实现，它允许完全内省，并允许您的用户做任何事情（包括 mutation）。 如果您需要更具体的实现，我建议您创建自己的 MCP 并锁定工具调用，以便客户端仅输入特定的查询字段和/或变量。 您可以使用此作为参考。