GraphQL 模式模型上下文协议服务器

一个将GraphQL模式信息暴露给大型语言模型（LLMs）如Claude的Model Context Protocol (MCP) 服务器。该服务器允许LLM探索和理解GraphQL模式。

功能

• 加载通过命令行参数指定的任意GraphQL模式文件
• 探索查询、突变和订阅字段
• 查看详细类型定义
• 使用模式匹配搜索类型和字段
• 获取简化的字段信息，包括类型和参数
• 过滤掉内部GraphQL类型以获得更清洁的结果

使用方法

命令行

运行MCP服务器并指定特定的模式文件：

# 使用当前目录中的默认schema.graphqls
npx -y mcp-graphql-schema

# 使用相对路径的特定模式文件
npx -y mcp-graphql-schema ../schema.shopify.2025-01.graphqls

# 使用绝对路径的模式文件
npx -y mcp-graphql-schema /absolute/path/to/schema.graphqls

# 显示帮助信息
npx -y mcp-graphql-schema --help

Claude Desktop 集成

要在Claude Desktop中使用此MCP服务器，请编辑claude_desktop_config.json配置文件：

{
  "mcpServers": {
    "GraphQL Schema": {
      "command": "npx",
      "args": ["-y", "mcp-graphql-schema", "/ABSOLUTE/PATH/TO/schema.graphqls"]
    }
  }
}

配置文件位置：

• macOS/Linux: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: $env:AppData\Claude\claude_desktop_config.json

Claude Code 集成

要在Claude Code CLI中使用此MCP服务器，请按照以下步骤操作：

1. 将GraphQL模式MCP服务器添加到Claude Code

   # 基本语法
   claude mcp add graphql-schema npx -y mcp-graphql-schema
   
   # 示例带有特定模式的
   claude mcp add shopify-graphql-schema npx -y mcp-graphql-schema  ~/Projects/work/schema.shopify.2025-01.graphqls
   

2. 验证注册的MCP服务器

   # 列出所有配置好的服务器
   claude mcp list
   
   # 获取GraphQL模式服务器的详细信息
   claude mcp get graphql-schema
   

3. 如果需要可以删除服务器

   claude mcp remove graphql-schema
   

4. 在Claude Code中使用工具

   配置完成后，您可以在Claude Code会话中通过询问关于GraphQL模式的问题来调用该工具。

技巧：

• 使用-s或--scope标志与project（默认）或global指定配置存储的位置
• 为不同的模式添加多个MCP服务器（例如主要API模式、Shopify模式）

MCP 工具

该服务器为LLM提供了以下工具来与GraphQL模式交互：

• list-query-fields: 列出所有可用的根级别查询字段
• get-query-field: 获取特定查询字段的详细SDL定义
• list-mutation-fields: 列出所有可用的根级别突变字段
• get-mutation-field: 获取特定突变字段的详细SDL定义
• list-subscription-fields: 列出所有可用的根级别订阅字段（如果模式中有订阅）
• get-subscription-field: 获取特定订阅字段的详细信息（如果模式中有订阅）
• list-types: 列出GraphQL模式中定义的所有类型（排除内部类型）
• get-type: 获取特定GraphQL类型的详细SDL定义
• get-type-fields: 获取特定GraphQL对象类型的简化字段列表及其类型
• search-schema: 使用模式匹配搜索类型和字段

示例查询

# 查询示例：
# 列出所有可用的根级别查询字段
mcp query --tool list-query-fields

通过以上工具和技术，您可以有效地在GraphQL模式中进行交互和探索。