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.

Integrations

Enables LLMs to interact with GraphQL APIs by providing schema introspection and query execution capabilities, allowing models to discover and use GraphQL APIs dynamically

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

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.

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

MCP para trabajar con servidores GraphQL.