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 schema indica a gqai dónde ejecutar las operaciones. Debe ser un servidor activo, no un archivo de esquema estático.

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>

gqai

Integrations

gqai

✨ Características

🛠️ Instalación

🚀 Inicio rápido

Uso

Configuración

Configuración de GraphQL

Encabezados

Configuración de MCP

Escritorio de Claude

Pruebas CLI

Llame a una herramienta a través de CLI para probar:

Llamar a una herramienta con argumentos:

Desarrollo

Prerrequisitos

Construir

Prueba

Formato

Ejecutar el servidor MCP

Ejecutar CLI

Acerca de GQAI

🤖¿Por qué gqai?

📜 Licencia

👋 Autor

Related MCP Servers

GCP MCP Server

Algoliaofficial

MCP_WolframAlpha

mcp-glama-demo

New MCP Servers