mcp-graphql

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

使用方法

运行 mcp-graphql 时指定正确的端点，它将自动尝试introspect你的查询。

命令行参数

示例

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

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

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

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

可用工具

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

1. introspect-schema: 此工具检索GraphQL模式。如果你没有访问模式资源的权限，请先使用此工具。 这将使用本地模式文件或基于 introspection 查询。

2. query-graphql: 对端点执行GraphQL查询。默认情况下禁用突变操作，除非指定 --enable-mutations。

资源

• graphql-schema: 服务器公开GraphQL模式作为资源，供客户端访问。这是本地模式文件或基于 introspection 查询的结果。

安装

通过Smithery安装

要通过 Smithery 自动安装 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"]
    }
  }
}

安全注意事项

突变默认禁用，作为安全措施，以防止LLM修改你的数据库或服务数据。在生产环境中启用突变操作时请谨慎考虑。

自定义自己的服务器

这是一个非常通用的实现，允许完全 introspection 并且允许用户执行任何操作（包括突变）。如果你需要更特定的实现，建议创建你自己的MCP，并限制客户端调用工具以仅输入特定的查询字段和/或变量。你可以以此为参考。