GraphQL Schema Model Context Protocol Server
A Model Context Protocol (MCP) server that exposes GraphQL schema information to Large Language Models (LLMs) like Claude. This server allows an LLM to explore and understand GraphQL schemas through a set of specialized tools.
Features
- Load any GraphQL schema file specified via command line argument
- Explore query, mutation, and subscription fields
- Look up detailed type definitions
- Search for types and fields using pattern matching
- Get simplified field information including types and arguments
- Filter out internal GraphQL types for cleaner results
Usage
Command Line
Run the MCP server with a specific schema file:
Claude Desktop Integration
To use this MCP server with Claude Desktop, edit your
claude_desktop_config.json configuration file:Location of the configuration file:
- macOS/Linux:
~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:
$env:AppData\Claude\claude_desktop_config.json
Claude Code Integration
To use this MCP server with Claude Code CLI, follow these steps:
- Add the GraphQL Schema MCP server to Claude Code
- Verify the MCP server is registered
- Remove the server if needed
- Use the tool in Claude CodeOnce configured, you can invoke the tool in your Claude Code session by asking questions about the GraphQL schema.
Tips:
- Use the
-sor--scopeflag withproject(default) orglobalto specify where the configuration is stored
- Add multiple MCP servers for different schemas with different names (e.g., main API schema, Shopify schema)
MCP Tools
The server provides the following tools for LLMs to interact with GraphQL schemas:
list-query-fields: Lists all available root-level fields for GraphQL queries
get-query-field: Gets detailed definition for a specific query field in SDL format
list-mutation-fields: Lists all available root-level fields for GraphQL mutations
get-mutation-field: Gets detailed definition for a specific mutation field in SDL format
list-subscription-fields: Lists all available root-level fields for GraphQL subscriptions (if present in schema)
get-subscription-field: Gets detailed definition for a specific subscription field (if present in schema)
list-types: Lists all types defined in the GraphQL schema (excluding internal types)
get-type: Gets detailed definition for a specific GraphQL type in SDL format
get-type-fields: Gets a simplified list of fields with their types for a specific GraphQL object type
search-schema: Searches for types or fields in the schema by name pattern (case-insensitive regex)
Examples
Example queries to try:
GraphQL Schema Model Context Protocol Server
A Model Context Protocol (MCP) server that exposes GraphQL schema information to Large Language Models (LLMs) like Claude. This server allows an LLM to explore and understand GraphQL schemas through a set of specialized tools.
Features
- Load any GraphQL schema file specified via command line argument
- Explore query, mutation, and subscription fields
- Look up detailed type definitions
- Search for types and fields using pattern matching
- Get simplified field information including types and arguments
- Filter out internal GraphQL types for cleaner results
Usage
Command Line
Run the MCP server with a specific schema file:
Claude Desktop Integration
To use this MCP server with Claude Desktop, edit your
claude_desktop_config.json configuration file:Location of the configuration file:
- macOS/Linux:
~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:
$env:AppData\Claude\claude_desktop_config.json
Claude Code Integration
To use this MCP server with Claude Code CLI, follow these steps:
- Add the GraphQL Schema MCP server to Claude Code
- Verify the MCP server is registered
- Remove the server if needed
- Use the tool in Claude CodeOnce configured, you can invoke the tool in your Claude Code session by asking questions about the GraphQL schema.
Tips:
- Use the
-sor--scopeflag withproject(default) orglobalto specify where the configuration is stored
- Add multiple MCP servers for different schemas with different names (e.g., main API schema, Shopify schema)
MCP Tools
The server provides the following tools for LLMs to interact with GraphQL schemas:
list-query-fields: Lists all available root-level fields for GraphQL queries
get-query-field: Gets detailed definition for a specific query field in SDL format
list-mutation-fields: Lists all available root-level fields for GraphQL mutations
get-mutation-field: Gets detailed definition for a specific mutation field in SDL format
list-subscription-fields: Lists all available root-level fields for GraphQL subscriptions (if present in schema)
get-subscription-field: Gets detailed definition for a specific subscription field (if present in schema)
list-types: Lists all types defined in the GraphQL schema (excluding internal types)
get-type: Gets detailed definition for a specific GraphQL type in SDL format
get-type-fields: Gets a simplified list of fields with their types for a specific GraphQL object type
search-schema: Searches for types or fields in the schema by name pattern (case-insensitive regex)
Examples
Example queries to try: