gqai
graphql → ai
gqai is a lightweight proxy that exposes GraphQL operations as
Model Context Protocol (MCP) tools for AI like
Claude, Cursor, and ChatGPT.
Define tools using regular GraphQL queries/mutations against your GraphQL backend, and gqai automatically
generates an MCP server for you.
🔌 Powered by your GraphQL backend
⚙️ Driven by .graphqlrc.yml + plain .graphql files
✨ Features
- 🧰 Define tools using GraphQL operations
- 🗂 Automatically discover operations from
.graphqlrc.yml - 🧾 Tool metadata compatible with OpenAI function calling / MCP
🛠️ Installation
go install github.com/fotoetienne/gqai@latest🚀 Quick Start
- Create a .graphqlrc.yml:
schema: https://graphql.org/graphql/
documents: .This file tells gqai where to find your GraphQL schema and operations.
Note: The schema parameter tells gqai where to execute the operations. This must be a live server rather than a static schema file
- Add a GraphQL operation
get_all_films.graphql:
# Get all Star Wars films
query get_all_films {
allFilms {
films {
title
episodeID
}
}
}
