mcp-graphql-schema

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:

Integración de escritorio de Claude

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

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 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: