mcp-graphql

mcp-graphql

Um servidor Model Context Protocol que permite que LLMs interajam com APIs GraphQL. Esta implementação fornece capacidades de introspecção de esquema e execução de consultas, permitindo que modelos descubram e usem APIs GraphQL dinamicamente.

Uso

Execute mcp-graphql com o endpoint correto, ele tentará automaticamente fazer a introspecção das suas consultas.

Argumentos de Linha de Comando

Argumento	Descrição	Padrão
--endpoint	URL do endpoint GraphQL	http://localhost:4000/graphql
--headers	String JSON contendo cabeçalhos para requisições	{}
--enable-mutations	Habilita operações de mutação (desabilitado por padrão)	false
--name	Nome do servidor MCP	mcp-graphql
--schema	Caminho para um arquivo de esquema GraphQL local (opcional)	-

Exemplos

# Basic usage with a local GraphQL server
npx mcp-graphql --endpoint http://localhost:3000/graphql

# Using with custom headers
npx mcp-graphql --endpoint https://api.example.com/graphql --headers '{"Authorization":"Bearer token123"}'

# Enable mutation operations
npx mcp-graphql --endpoint http://localhost:3000/graphql --enable-mutations

# Using a local schema file instead of introspection
npx mcp-graphql --endpoint http://localhost:3000/graphql --schema ./schema.graphql

Ferramentas Disponíveis

O servidor fornece duas ferramentas principais:

1. introspect-schema: Esta ferramenta recupera o esquema GraphQL. Use esta primeiro se você não tiver acesso ao esquema como um recurso. Ela usa o arquivo de esquema local ou uma consulta de introspecção.

2. query-graphql: Executa consultas GraphQL contra o endpoint. Por padrão, mutações são desabilitadas a menos que --enable-mutations seja especificado.

Recursos

• graphql-schema: O servidor expõe o esquema GraphQL como um recurso que os clientes podem acessar. Este é o arquivo de esquema local ou baseado em uma consulta de introspecção.

Instalação

Instalando via Smithery

Para instalar o GraphQL MCP Toolkit para Claude Desktop automaticamente via Smithery:

npx -y @smithery/cli install mcp-graphql --client claude

Instalando Manualmente

Ele pode ser instalado manualmente no Claude:

{
  "mcpServers": {
    "mcp-graphql": {
      "command": "npx",
      "args": ["mcp-graphql", "--endpoint", "http://localhost:3000/graphql"]
    }
  }
}

Considerações de Segurança

Mutações são desabilitadas por padrão como uma medida de segurança para evitar que um LLM modifique seu banco de dados ou dados de serviço. Considere cuidadosamente antes de habilitar mutações em ambientes de produção.

Personalize para o seu próprio servidor

Esta é uma implementação muito genérica que permite introspecção completa e que seus usuários façam o que quiserem (incluindo mutações). Se você precisar de uma implementação mais específica, sugiro criar seu próprio MCP e restringir a chamada de ferramentas para que os clientes apenas insiram campos de consulta e/ou variáveis específicos. Você pode usar este como referência.