mcp-graphql 中文翻译

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

使用方法

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

环境变量（1.0.0版本的重大变更）

注意： 从版本1.0.0开始，命令行参数已替换为环境变量。

示例

# 基本使用，与本地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 ALLOW_MUTATIONS=true npx mcp-graphql

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

资源

• graphql-schema：服务器暴露GraphQL模式作为资源，客户端可以访问。这要么是本地模式文件，要么基于introspection查询。

可用工具

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

1. introspect-schema：此工具检索GraphQL模式。如果你没有模式资源，请先使用此工具。 这使用本地模式文件或introspection查询。

2. query-graphql：对端点执行GraphQL查询。默认情况下禁用变异操作，除非ALLOW_MUTATIONS设置为true。

安装

通过Smithery安装

要自动通过Smithery安装GraphQL MCP服务器以用于Claude Desktop：

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

手动安装

可以手动安装到Claude：

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

安全注意事项

默认情况下禁用变异操作，作为一种安全措施。请谨慎考虑在生产环境中启用变异操作。

为自己的服务器自定义

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