Skip to main content
Glama

mcp-graphql

mcp-graphql

Un servidor de Protocolo de Contexto de Modelo que permite a los LLM interactuar con las API de GraphQL. Esta implementación proporciona introspección de esquemas y funciones de ejecución de consultas, lo que permite a los modelos descubrir y utilizar las API de GraphQL dinámicamente.

Uso

Ejecute mcp-graphql con el punto final correcto; automáticamente intentará introspeccionar sus consultas.

Variables de entorno (cambio importante en la versión 1.0.0)

Nota: A partir de la versión 1.0.0, los argumentos de la línea de comandos han sido reemplazados por variables de entorno.

Variable de entornoDescripciónPor defecto
ENDPOINTURL del punto final de GraphQLhttp://localhost:4000/graphql
HEADERSCadena JSON que contiene encabezados para solicitudes{}
ALLOW_MUTATIONSHabilitar operaciones de mutación (deshabilitado de forma predeterminada)false
NAMENombre del servidor MCPmcp-graphql
SCHEMARuta a un archivo de esquema GraphQL local (opcional)-

Ejemplos

# Basic usage with a local GraphQL server ENDPOINT=http://localhost:3000/graphql npx mcp-graphql # Using with custom headers ENDPOINT=https://api.example.com/graphql HEADERS='{"Authorization":"Bearer token123"}' npx mcp-graphql # Enable mutation operations ENDPOINT=http://localhost:3000/graphql ALLOW_MUTATIONS=true npx mcp-graphql # Using a local schema file instead of introspection ENDPOINT=http://localhost:3000/graphql SCHEMA=./schema.graphql npx mcp-graphql

Recursos

  • graphql-schema : El servidor expone el esquema GraphQL como un recurso al que los clientes pueden acceder. Este puede ser el archivo de esquema local o una consulta de introspección.

Herramientas disponibles

El servidor proporciona dos herramientas principales:

  1. introspect-schema : Esta herramienta recupera el esquema de GraphQL. Úsela primero si no tiene acceso al esquema como recurso. Utiliza el archivo de esquema local o una consulta de introspección.
  2. query-graphql : Ejecuta consultas GraphQL en el endpoint. Por defecto, las mutaciones están deshabilitadas a menos que ALLOW_MUTATIONS se configure como true .

Instalación

Instalación mediante herrería

Para instalar GraphQL MCP Server para Claude Desktop automáticamente a través de Smithery :

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

Instalación manual

Se puede instalar manualmente en Claude:

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

Consideraciones de seguridad

Las mutaciones están deshabilitadas por defecto como medida de seguridad para evitar que un LLM modifique los datos de su base de datos o servicio. Piénselo bien antes de habilitar mutaciones en entornos de producción.

Personalízalo para tu propio servidor

Esta es una implementación muy genérica que permite una introspección completa y que los usuarios puedan hacer lo que quieran (incluidas las mutaciones). Si necesitas una implementación más específica, te sugiero crear tu propio MCP y restringir las llamadas a herramientas para que los clientes solo introduzcan campos de consulta o variables específicos. Puedes usar esto como referencia.

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

MCP para trabajar con servidores GraphQL.

  1. Uso
    1. Variables de entorno (cambio importante en la versión 1.0.0)
    2. Ejemplos
  2. Recursos
    1. Herramientas disponibles
      1. Instalación
        1. Instalación mediante herrería
        2. Instalación manual
      2. Consideraciones de seguridad
        1. Personalízalo para tu propio servidor

          Related MCP Servers

          • -
            security
            F
            license
            -
            quality
            An MCP server that enables graph database interactions with Neo4j, allowing users to access and manipulate graph data through natural language commands.
            Last updated -
            Python
          • -
            security
            A
            license
            -
            quality
            A MCP server that exposes GraphQL schema information to LLMs like Claude. This server allows an LLM to explore and understand large GraphQL schemas through a set of specialized tools, without needing to load the whole schema into the context
            Last updated -
            58
            26
            JavaScript
            MIT License
            • Apple
            • Linux
          • A
            security
            A
            license
            A
            quality
            A Model Context Protocol (MCP) server that connects GraphDB's SPARQL endpoints and Ollama models to Claude, enabling Claude to query and manipulate ontology data while leveraging various AI models.
            Last updated -
            28
            1
            TypeScript
            MIT License
            • Apple
            • Linux

          View all related MCP servers

          MCP directory API

          We provide all the information about MCP servers via our MCP API.

          curl -X GET 'https://glama.ai/api/mcp/v1/servers/blurrah/mcp-graphql'

          If you have feedback or need assistance with the MCP directory API, please join our Discord server