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.