hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

Exposes GraphQL schema information to explore query, mutation, and subscription fields, look up type definitions, search for types and fields, and get simplified field information.
Supports loading Shopify GraphQL schemas, allowing exploration of Shopify's API structure through the MCP server.

Servidor de protocolo de contexto del modelo de esquema GraphQL

Un servidor de Protocolo de Contexto de Modelo (MCP) que expone la información del esquema GraphQL a Modelos de Lenguaje Grandes (LLM) como Claude. Este servidor permite a un LLM explorar y comprender los esquemas GraphQL mediante un conjunto de herramientas especializadas.

Características

Cargue cualquier archivo de esquema GraphQL especificado a través del argumento de la línea de comando
Explorar campos de consulta, mutación y suscripción
Busque definiciones de tipos detalladas
Busque tipos y campos mediante la coincidencia de patrones
Obtenga información de campo simplificada, incluidos tipos y argumentos
Filtrar tipos internos de GraphQL para obtener resultados más limpios

Uso

Línea de comandos

Ejecute el servidor MCP con un archivo de esquema específico:

# 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

Integración de escritorio de Claude

Para utilizar este servidor MCP con Claude Desktop, edite su archivo de configuración claude_desktop_config.json :

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

Ubicación del archivo de configuración:

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

Integración de Claude Code

Para utilizar este servidor MCP con Claude Code CLI, siga estos pasos:

Agregue el servidor MCP del esquema GraphQL a Claude Code
# 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
Verifique que el servidor MCP esté registrado
# List all configured servers claude mcp list # Get details for your GraphQL schema server claude mcp get graphql-schema
Quitar el servidor si es necesario
claude mcp remove graphql-schema
Utilice la herramienta en Claude CodeUna vez configurada, puede invocar la herramienta en su sesión de Claude Code haciendo preguntas sobre el esquema GraphQL.

Consejos:

Utilice el indicador -s o --scope con project (predeterminado) o global para especificar dónde se almacena la configuración
Agregue varios servidores MCP para diferentes esquemas con diferentes nombres (por ejemplo, esquema de API principal, esquema de Shopify)

Herramientas MCP

El servidor proporciona las siguientes herramientas para que los LLM interactúen con esquemas GraphQL:

list-query-fields : enumera todos los campos de nivel raíz disponibles para consultas GraphQL
get-query-field : obtiene la definición detallada de un campo de consulta específico en formato SDL
list-mutation-fields : enumera todos los campos de nivel raíz disponibles para las mutaciones de GraphQL
get-mutation-field : obtiene la definición detallada de un campo de mutación específico en formato SDL
list-subscription-fields : enumera todos los campos de nivel raíz disponibles para las suscripciones GraphQL (si están presentes en el esquema)
get-subscription-field : obtiene la definición detallada de un campo de suscripción específico (si está presente en el esquema)
list-types : enumera todos los tipos definidos en el esquema GraphQL (excluidos los tipos internos)
get-type : obtiene la definición detallada de un tipo GraphQL específico en formato SDL
get-type-fields : obtiene una lista simplificada de campos con sus tipos para un tipo de objeto GraphQL específico
search-schema : busca tipos o campos en el esquema por patrón de nombre (expresión regular que no distingue entre mayúsculas y minúsculas)

Ejemplos

Ejemplos de consultas para probar:

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".

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

Un servidor MCP que expone la información del esquema GraphQL a LLM como Claude. Este servidor permite a un LLM explorar y comprender esquemas GraphQL extensos mediante un conjunto de herramientas especializadas, sin necesidad de cargar el esquema completo en el contexto.

Related Resources

Reddit Discussion about this server