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.

Argumentos de la línea de comandos

Argumento	Descripción	Por defecto
`--endpoint`	URL del punto final de GraphQL	`http://localhost:4000/graphql`
`--headers`	Cadena JSON que contiene encabezados para solicitudes	`{}`
`--enable-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
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

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 se especifique --enable-mutations .

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.

Instalación

Instalación mediante herrería

Para instalar GraphQL MCP Toolkit 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", "--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.

Integrations