mcp4gql

mcp4gql - Servidor MCP de GraphQL

Este proyecto es un servidor Node.js/TypeScript que implementa el Protocolo de Contexto de Modelos (MCP). Actúa como un puente, permitiendo que clientes MCP (como Cursor) interactúen con una API GraphQL de destino.

Características

• Servidor MCP: Implementa la clase Server de MCP desde @modelcontextprotocol/sdk.
• Transporte Stdio: Se comunica con los clientes a través de la entrada/salida estándar.
• Cliente GraphQL: Utiliza axios para enviar solicitudes al endpoint GraphQL configurado.
• Herramientas GraphQL Genéricas: Expone las siguientes herramientas a los clientes MCP:
  • introspectGraphQLSchema: Obtiene el esquema de la API GraphQL de destino mediante introspección.
  • executeGraphQLOperation: Ejecuta consultas o mutaciones GraphQL arbitrarias contra la API de destino, tomando query, variables opcional y operationName opcional como entrada.

Configuración

El servidor requiere las siguientes variables de entorno:

• GRAPHQL_ENDPOINT: La URL de la API GraphQL de destino.
• AUTH_TOKEN: Un token de portador para un encabezado Authorization: Bearer <token> opcional para autenticarse con la API GraphQL.

Configuración del Cliente

Para permitir que clientes como Cursor o Claude Desktop utilicen las herramientas proporcionadas por este servidor, debes configurarlos para ejecutar el comando npx.

Cursor

1. Ve a Configuración MCP de Cursor (Cursor > Configuración > Configuración de Cursor > MCP)

2. Ve a + Agregar nuevo servidor MCP global

3. Agrega lo siguiente a tu configuración MCP de Cursor:

   {
     "mcpServers": {
       "mcp4gql": {
         "command": "npx",
         "type": "stdio",
         "args": ["-y", "mcp4gql"],
         "env": {
           "GRAPHQL_ENDPOINT": "YOUR_GRAPHQL_ENDPOINT_URL",
           "AUTH_TOKEN": "YOUR_OPTIONAL_AUTH_TOKEN"
         }
       }
     }
   }
   

Claude Desktop

1. Abre la configuración de Claude Desktop (Claude > Configuración).

2. Ve a Desarrollador > Editar configuración.

3. Agrega a la configuración:

   {
     "mcpServers": {
       "mcp4gql": {
         "command": "npx",
         "args": ["-y", "mcp4gql"],
         "env": {
           "GRAPHQL_ENDPOINT": "YOUR_GRAPHQL_ENDPOINT_URL",
           "AUTH_TOKEN": "YOUR_OPTIONAL_AUTH_TOKEN"
         }
       }
     }
   }
   

Una vez configurado, el cliente MCP debería poder listar y llamar a las herramientas introspectGraphQLSchema y executeGraphQLOperation proporcionadas por este servidor cuando sea relevante. Recuerda establecer las variables de entorno requeridas (GRAPHQL_ENDPOINT y opcionalmente AUTH_TOKEN) en la configuración para que el servidor pueda conectarse a tu API.