MIT License
gqai
graphql → inteligencia artificial
gqai es un proxy liviano que expone las operaciones GraphQL como herramientas del Protocolo de Contexto de Modelo (MCP) para IA como Claude, Cursor y ChatGPT.
Defina herramientas que utilicen consultas/mutaciones GraphQL regulares contra su backend GraphQL y gqai generará automáticamente un servidor MCP para usted.
🔌 Desarrollado por su backend GraphQL
⚙️ Impulsado por .graphqlrc.yml + archivos .graphql simples
✨ Características
🧰 Definir herramientas utilizando operaciones GraphQL
🗂 Descubra automáticamente operaciones desde
.graphqlrc.yml🧾 Metadatos de la herramienta compatibles con la llamada a funciones de OpenAI / MCP
🛠️ Instalación
go install github.com/fotoetienne/gqai@latest
🚀 Inicio rápido
Crea un .graphqlrc.yml:
schema: https://graphql.org/graphql/
documents: .
Este archivo le dice a gqai dónde encontrar su esquema y operaciones GraphQL.
Nota: El parámetro
Agregar una operación GraphQL
get_all_films.graphql :
# Get all Star Wars films
query get_all_films {
allFilms {
films {
title
episodeID
}
}
}
Agregue gqai a su archivo
mcp.json:
"gqai": {
"command": "gqai",
"args": [
"run",
"--config"
".graphqlrc.yml"
]
}
¡Listo! Tu modelo de IA ya puede llamar a la herramienta get_all_films .
Uso
Configuración
Configuración de GraphQL
El archivo de configuración de GraphQL es un archivo YAML que define el punto final de GraphQL y las operaciones que desea exponer como herramientas. Debe llamarse .graphqlrc.yml y ubicarse en la raíz del proyecto.
schema: https://graphql.org/graphql/
documents: operations
El campo schema especifica el punto final de GraphQL y el campo documents especifica el directorio donde se encuentran sus operaciones de GraphQL.
En este ejemplo, el directorio operations contiene todas las operaciones GraphQL que desea exponer como herramientas. Las operaciones se definen en archivos .graphql y gqai las detectará automáticamente.
Encabezados
También puede especificar los encabezados que se enviarán con cada solicitud al endpoint de GraphQL. Esto resulta útil para la autenticación u otros encabezados personalizados.
schema:
- https://graphql.org/graphql/:
headers:
Authorization: Bearer YOUR_TOKEN
X-Custom-Header: CustomValue
documents: .
Configuración de MCP
Escritorio de Claude
Para usar gqai con Claude Desktop, debe agregar la siguiente configuración a su archivo mcp.json :
{
"gqai": {
"command": "gqai",
"args": [
"run",
"--config",
".graphqlrc.yml"
]
}
}
Pruebas CLI
Llame a una herramienta a través de CLI para probar:
gqai tools/call get_all_films
Esto ejecutará la herramienta get_all_films e imprimirá el resultado.
{
"data": {
"allFilms": {
"films": [
{
"id": 4,
"title": "A New Hope"
},
{
"id": 5,
"title": "The Empire Strikes Back"
},
{
"id": 6,
"title": "Return of the Jedi"
},
...
]
}
}
}
Llamar a una herramienta con argumentos:
Cree una operación GraphQL que tome argumentos, y estos serán las entradas de la herramienta:
get_film_by_id.graphql :
query get_film_by_id($id: ID!) {
film(filmID: $id) {
episodeID
title
director
releaseDate
}
}
Llamar a la herramienta con argumentos:
gqai tools/call get_film_by_id '{"id": "1"}'
Esto ejecutará la herramienta get_film_by_id con los argumentos proporcionados.
{
"data": {
"film": {
"episodeID": 1,
"title": "A New Hope",
"director": "George Lucas",
"releaseDate": "1977-05-25"
}
}
}
Desarrollo
Prerrequisitos
Vaya 1.20+
Construir
go build -o gqai main.go
Prueba
go test ./...
Formato
go fmt ./...
Ejecutar el servidor MCP
./gqai run --config .graphqlrc.yml
Ejecutar CLI
./gqai tools/call get_all_films
Acerca de GQAI
🤖¿Por qué gqai?
gqai facilita la conversión de tu backend de GraphQL en una capa de herramientas lista para usar: sin código ni infraestructura adicional. Simplemente define tus operaciones y deja que la IA las ejecute.
📜 Licencia
MIT: bifurcarlo, construir sobre él, todas las cosas.
👋 Autor
Hecho con ❤️ y 🤖vibraciones por Stephen Spalding y <your-name-here>
This server cannot be installed
Related Resources
Related MCP Servers
- MIT License
- AsecurityAlicenseAqualityEnables AI models to search, retrieve, and utilize GIFs from Giphy with features like content filtering, multiple search methods, and comprehensive metadata.Last updated -31823MIT License
- MIT License