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

Related MCP server: mcp4gql

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:

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

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

3. Quitar el servidor si es necesario

   claude mcp remove graphql-schema

4. Utilice la herramienta en Claude Code

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