mcp4gql

mcp4gql - Servidor MCP GraphQL

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

Características

• Servidor MCP: implementa la clase Server MCP de @modelcontextprotocol/sdk .
• Transporte Stdio: se comunica con los clientes a través de entrada/salida estándar.
• Cliente GraphQL: utiliza axios para enviar solicitudes al punto final GraphQL configurado.
• Herramientas genéricas de GraphQL: expone las siguientes herramientas a los clientes MCP:
  • introspectGraphQLSchema : obtiene el esquema de API GraphQL de destino mediante introspección.
  • executeGraphQLOperation : ejecuta consultas o mutaciones GraphQL arbitrarias contra la API de destino, tomando query , variables 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 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, debe configurarlos para ejecutar el comando npx .

Cursor

1. Vaya a Configuración del cursor MCP (Cursor > Configuración > Configuración del cursor > MCP)
2. Vaya a + Agregar nuevo servidor MCP global
3. Agregue lo siguiente a su configuración de Cursor MCP:
   { "mcpServers": { "mcp4gql": { "command": "npx", "type": "stdio", "args": ["-y", "mcp4gql"], "env": { "GRAPHQL_ENDPOINT": "YOUR_GRAPHQL_ENDPOINT_URL", "AUTH_TOKEN": "YOUR_OPTIONAL_AUTH_TOKEN" } } } }

Escritorio de Claude

1. Abra la configuración de Claude Desktop (Claude > Configuración).
2. Vaya a Desarrollador > Editar configuración.
3. Agregar 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 necesario. Recuerde configurar las variables de entorno necesarias ( GRAPHQL_ENDPOINT y, opcionalmente, AUTH_TOKEN ) para que el servidor pueda conectarse a su API.