mcp-graphql

insignia de herrería

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 entorno	Descripción	Por defecto
`ENDPOINT`	URL del punto final de GraphQL	`http://localhost:4000/graphql`
`HEADERS`	Cadena JSON que contiene encabezados para solicitudes	`{}`
`ALLOW_MUTATIONS`	Habilitar operaciones de mutación (deshabilitado de forma predeterminada)	`false`
`NAME`	Nombre del servidor MCP	`mcp-graphql`
`SCHEMA`	Ruta 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

Related MCP server: mcp-graphql-schema

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:

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.
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.