MCP Graphql Schema

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

一个模型上下文协议（MCP）服务器，将GraphQL模式信息暴露给像Claude这样的大型语言模型（LLM）。此服务器允许LLM通过一组专用工具探索和理解GraphQL模式。

特性

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

用法

命令行

使用特定的架构文件运行MCP服务器：

# Use the default schema.graphqls in current directory
npx -y mcp-graphql-schema

# Use a specific schema file (relative path)
npx -y mcp-graphql-schema ../schema.shopify.2025-01.graphqls

# Use a specific schema file (absolute path)
npx -y mcp-graphql-schema /absolute/path/to/schema.graphqls

# Show help
npx -y mcp-graphql-schema --help

通过Smithery安装

通过以下方式自动安装Claude Desktop的GraphQL Schema 史密瑟里:

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

Claude桌面集成

要将此MCP服务器与Claude Desktop一起使用，请编辑您的 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
• 窗户： $env:AppData\Claude\claude_desktop_config.json

Claude代码集成

要将此MCP服务器与Claude Code CLI一起使用，请执行以下步骤：

1. 将GraphQL Schema MCP服务器添加到Claude代码中

   # Basic syntax
   claude mcp add graphql-schema npx -y mcp-graphql-schema

   # Example with specific schema
   claude mcp add shopify-graphql-schema npx -y mcp-graphql-schema  ~/Projects/work/schema.shopify.2025-01.graphqls

1. 验证MCP服务器是否已注册

   # List all configured servers
   claude mcp list

   # Get details for your GraphQL schema server
   claude mcp get graphql-schema

1. 如果需要，请删除服务器

   claude mcp remove graphql-schema

1. 使用Claude Code中的工具

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

提示：

• 使用 -s 或 --scope 旗与 project （默认）或 global 指定配置的存储位置
• 为具有不同名称的不同架构添加多个MCP服务器（例如，主API架构、Shopify架构）

MCP工具

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

• list-query-fields：列出GraphQL查询的所有可用根级字段
• get-query-field：获取SDL格式的特定查询字段的详细定义
• list-mutation-fields：列出GraphQL突变的所有可用根级别字段
• get-mutation-field：获取SDL格式的特定变异字段的详细定义
• list-subscription-fields：列出GraphQL订阅的所有可用根级字段（如果存在于架构中）
• get-subscription-field：获取特定订阅字段的详细定义（如果架构中存在）
• list-types：列出GraphQL架构中定义的所有类型（不包括内部类型）
• get-type：获取SDL格式的特定GraphQL类型的详细定义
• get-type-fields：获取特定GraphQL对象类型的字段及其类型的简化列表
• search-schema：按名称模式搜索模式中的类型或字段（不区分大小写的正则表达式）

例子

要尝试的示例查询：

What query fields are available in this GraphQL schema?
Show me the details of the "user" query field.
What mutation operations can I perform in this schema?
List all types defined in this schema.
Show me the definition of the "Product" type.
List all fields of the "Order" type.
Search for types and fields related to "customer".