Graphql MCP Toolkit

🚀 mcp-graphql

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

🚀 快速开始

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

📦 安装指南

通过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"]
    }
  }
}

💻 使用示例

基础用法

# 基本使用方法，与本地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）查询的结果。

📚 详细文档

安全注意事项

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

自定义自己的服务器

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