К основному содержанию
MCP-сервер CX Codex

Text-to-GraphQL — MCP-сервер для Claude Code

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

лицензия не указана обновлён 2026-10-29

Открыть на GitHub

Что делает 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, придётся указать там же: без неё клиент не найдёт команду, и сервер не запустится.

Какие задачи решает

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

Примеры запросов агенту

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

Как установить Text-to-GraphQL

Установка

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

По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие

Вопросы о Text-to-GraphQL

Как установить Text-to-GraphQL?

Клонируйте репозиторий: git clone https://github.com/Arize-ai/text-to-graphql-mcp.git, затем cd text-to-graphql-mcp, uv sync и проверка uv run text-to-graphql-mcp --help. После этого добавьте сервер в конфиг MCP-клиента с командой uv --directory /path/to/text-to-graphql-mcp run text-to-graphql-mcp и переменными окружения.

Что делает Text-to-GraphQL?

Принимает запрос на обычном языке, собирает по нему GraphQL-запрос на основе вашей схемы, проверяет его и может сразу выполнить на эндпоинте. Внутри работает агент на LangGraph, история запросов хранится в пределах сессии.

Что нужно, чтобы сервер заработал?

Установленный uv и его каталог в переменной PATH внутри конфига MCP, ключ OPENAI_API_KEY, а также GRAPHQL_ENDPOINT и GRAPHQL_API_KEY для вашего API.

Похожие MCP-серверы

Все MCP-серверы по теме «Бэкенд и API» →
graphql-schema apollographql Скилл graphql-schema обучает проектированию схем GraphQL SDL по практикам Apollo. Помогает при создании schema.graphql, добавлении мутаций или настройке пагинации. CX Codex +1 4 500установок graphql-and-hidden-parameters yaklang Скилл graphql-and-hidden-parameters для Claude Code описывает проверку GraphQL и скрытых параметров: интроспекцию, батчинг, недокументированные поля и пробелы в авторизации. CX Codex +1 4 000установок vtex-io-graphql-api vtex Скилл vtex-io-graphql-api для Claude Code и Codex. Помогает описать GraphQL-схему и подключить резолверы в приложении VTEX IO через запросы и мутации. CX Codex +1 1 300установок graphql Mindrally Скилл graphql для Claude Code помогает проектировать GraphQL-схемы и оптимизировать запросы. Включается при разработке API и интеграции GraphQL-клиентов. CX Codex +1 726установок graphql-performance-optimizer davila7 Субагент graphql-performance-optimizer для Claude Code анализирует узкие места GraphQL API и предлагает изменения для запросов, резолверов и кэширования. Запускается при проблемах с N+1, пагинацией или задержками федерации. CX Codex 599установок graphql-api-development manutej Скилл graphql-api-development для Claude Code, Codex, Cursor, Copilot и Gemini CLI по построению GraphQL API: схема, типы, резолверы, мутации, подписки, аутентификация и кэширование. CX Codex +1 449установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой