# Text-to-GraphQL

MCP-сервер Text-to-GraphQL для Claude Code превращает запрос словами в GraphQL-запрос, проверяет по схеме и выполняет на вашем эндпоинте. Позволяет работать с большой схемой без запоминания имён полей.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Автор: arize-ai
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/arize-ai/text-to-graphql-mcp
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — внимание: команда скачивает скрипт с astral.sh и сразу его запускает; команда PowerShell скачивает скрипт с astral.sh и сразу его выполняет. Без явного «да» человека такие команды не запускай.
- HTML: https://affpapa.org/nevibecode/mcp/text-to-graphql

## Что делает

Сервер превращает фразу на обычном языке в запрос к вашему GraphQL API. Схема подгружается и интроспектируется сама, сгенерированный запрос проверяется по ней, а потом уходит на эндпоинт с нужной авторизацией. Переводит с человеческого на GraphQL агент на LangGraph.

Наружу отдаются инструменты `generate_graphql_query` (генерация), `validate_graphql_query` (проверка по схеме), `execute_graphql_query` (выполнение) и `get_query_history` (история запросов текущей сессии). Есть ещё `get_query_examples`. Схемы и часто используемые запросы кешируются, ошибки приходят с отладочной информацией.

Ставится через `uv`: клонируете репозиторий, делаете `uv sync`, прописываете сервер в конфиг MCP. В блок env нужны `OPENAI_API_KEY`, `GRAPHQL_ENDPOINT` и `GRAPHQL_API_KEY`, а способ авторизации выбирает `GRAPHQL_AUTH_TYPE` — `bearer`, `apikey` или `direct`. Переменную `PATH` с каталогом, где лежит `uv`, придётся указать там же: без неё клиент не найдёт команду, и сервер не запустится.

## Требования
- Нужно: Docker

## Установка

### Claude Code (родная платформа)

**Установка**
- Команды запуска нет в реестре MCP — смотрите README репозитория

## Когда брать
- собрать GraphQL-запрос по описанию словами, не держа схему в голове
- проверить сгенерированный запрос до отправки на эндпоинт
- выполнить запрос к API с bearer-токеном из конфига
- поднять историю запросов текущей сессии
- посмотреть готовые примеры запросов по незнакомой схеме

## Примеры запросов агенту
- Сгенерируй GraphQL-запрос: все заказы за прошлую неделю с суммой и статусом.
- Проверь этот запрос по загруженной схеме и, если он валиден, выполни его.
- Покажи историю запросов этой сессии.

## Похожие
- [graphql-schema](https://affpapa.org/nevibecode/skills/graphql-schema.md) — скилл · 4500 установок
- [graphql-and-hidden-parameters](https://affpapa.org/nevibecode/skills/graphql-and-hidden-parameters.md) — скилл · 4000 установок
- [vtex-io-graphql-api](https://affpapa.org/nevibecode/skills/vtex-io-graphql-api.md) — скилл · 1300 установок
- [graphql](https://affpapa.org/nevibecode/skills/mindrally-graphql.md) — скилл · 726 установок
- [graphql-performance-optimizer](https://affpapa.org/nevibecode/agents/graphql-performance-optimizer.md) — субагент · 599 установок
- [graphql-api-development](https://affpapa.org/nevibecode/skills/graphql-api-development.md) — скилл · 449 установок

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
