mcp4gql

mcp4gql - Servidor MCP GraphQL

Este projeto é um servidor Node.js/TypeScript que implementa o Protocolo de Contexto de Modelo (MCP). Ele atua como uma ponte, permitindo que clientes MCP (como o Cursor) interajam com uma API GraphQL de destino.

Recursos

• Servidor MCP: Implementa a classe Server do MCP a partir de @modelcontextprotocol/sdk.
• Transporte Stdio: Comunica-se com clientes via entrada/saída padrão.
• Cliente GraphQL: Usa axios para enviar requisições ao endpoint GraphQL configurado.
• Ferramentas GraphQL Genéricas: Expõe as seguintes ferramentas aos clientes MCP:
  • introspectGraphQLSchema: Busca o esquema da API GraphQL de destino usando introspecção.
  • executeGraphQLOperation: Executa consultas ou mutações GraphQL arbitrárias contra a API de destino, recebendo query, variables opcional e operationName opcional como entrada.

Configuração

O servidor requer as seguintes variáveis de ambiente:

• GRAPHQL_ENDPOINT: A URL da API GraphQL de destino.
• AUTH_TOKEN: Um token de portador para um cabeçalho Authorization: Bearer <token> opcional para autenticação com a API GraphQL.

Configuração do Cliente

Para permitir que clientes como Cursor ou Claude Desktop usem as ferramentas fornecidas por este servidor, você precisa configurá-los para executar o comando npx.

Cursor

1. Vá para Configurações MCP do Cursor (Cursor > Configurações > Configurações do Cursor > MCP)

2. Vá em + Adicionar novo servidor MCP global

3. Adicione o seguinte à sua configuração MCP do 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. Abra as configurações do Claude Desktop (Claude > Configurações).

2. Vá em Desenvolvedor > Editar Configuração.

3. Adicione à configuração:

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

Uma vez configurado, o cliente MCP deve ser capaz de listar e chamar as ferramentas introspectGraphQLSchema e executeGraphQLOperation fornecidas por este servidor quando relevante. Lembre-se de definir as variáveis de ambiente necessárias (GRAPHQL_ENDPOINT e opcionalmente AUTH_TOKEN) na configuração para que o servidor possa se conectar à sua API.