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 |
| URL del punto final de GraphQL |
|
| Cadena JSON que contiene encabezados para solicitudes |
|
| Habilitar operaciones de mutación (deshabilitado de forma predeterminada) |
|
| Nombre del servidor MCP |
|
| Ruta a un archivo de esquema GraphQL local (opcional) | - |
Ejemplos
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_MUTATIONSse configure comotrue.
Instalación
Instalación mediante herrería
Para instalar GraphQL MCP Server para Claude Desktop automáticamente a través de Smithery :
Instalación manual
Se puede instalar manualmente en Claude:
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.