그래픽 → ai

** gqai ** GraphQL 작업을 노출하는 경량 프록시입니다. 모형 Context 의정서 (MCP) AI를 위한 공구는 좋아합니다 Claude, 커서 및 ChatGPT. GraphQL 백엔드에 대한 일반 GraphQL 쿼리 / mutations를 사용하여 도구를 정의하고, gqai는 자동으로 MCP 서버를 생성합니다.

GraphQL 백엔드의 구동 .graphqlrc.yml] + 일반 [T1]] 파일

---

✨ 특징

• GraphQL 작업을 사용하여 De Define 도구
• .graphqlrc.yml]에서 자동 발견 작업
• OpenAI 함수 호출 / MCP와 호환되는 도구 메타데이터

---

672️ 설치

⭐ 빠른 시작

1. .graphqlrc.yml 만들기:

이 파일은 GraphQL 스키마 및 운영을 찾는 gqai를 말합니다.

Note: schema 매개변수는 Gqai가 동작을 실행하는 것을 말합니다. 이것은 정적 스키마 파일보다 오히려 라이브 서버이어야한다

2. GraphQL 가동 추가

get_all_films.graphql:

3. mcp.json 파일에 gqai를 추가하십시오:

그게 다야! AI 모델은 이제 get_all_films 툴을 호출할 수 있습니다.

사용법

윤곽

GraphQL 구성

graphql 설정 파일은 GraphQL 엔드포인트와 작업 정의 YAML 파일입니다. 도구로 노출 하시겠습니까.

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

1. 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

2. Add a GraphQL operation

get_all_films.graphql:

# Get all Star Wars films
query get_all_films {
  allFilms {
    films {
      title
      episodeID
    }
  }
}

3. Add gqai to your mcp.json file:

  "gqai": {
    "command": "gqai",
    "args": [
      "run",
      "--config"
      ".graphqlrc.yml"
    ]
  }

That’s it! Your AI model can now call the get_all_films tool.

Usage

Configuration

GraphQL Config

The graphql config file is a YAML file that defines the GraphQL endpoint and the operations you want to expose as tools. It should be named .graphqlrc.yml and placed in the root of your project.

schema: https://graphql.org/graphql/
documents: operations

The schema field specifies the GraphQL endpoint, and the documents field specifies the directory where your GraphQL operations are located.

In this example, the operations directory contains all the GraphQL operations you want to expose as tools. Operations are defined in .graphql files, and gqai will automatically discover them.

Headers

You can also specify headers to be sent with each request to the GraphQL endpoint. This is useful for authentication or other custom headers.

schema:
  - https://graphql.org/graphql/:
      headers:
        Authorization: Bearer YOUR_TOKEN
        X-Custom-Header: CustomValue
documents: .

Using Environment Variables in Headers

You can reference environment variables in header values using the ${VARNAME} syntax. For example:

schema:
  - https://graphql.org/graphql/:
      headers:
        Authorization: Bearer ${MY_AUTH_TOKEN}
documents: .

You can also provide a default value using the ${VARNAME:-default} syntax:

schema:
  - https://graphql.org/graphql/:
      headers:
        Authorization: Bearer ${MY_AUTH_TOKEN:-default-token}
documents: .