mcp-graphql — MCP-сервер для GraphQL API
mcp-graphql
Два инструмента для GraphQL: агент получает схему вашего API и выполняет запросы к нему через один эндпоинт
- 407 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Агент отправляет произвольные запросы к вашему API с заголовками авторизации из конфига
- Если включить ALLOW_MUTATIONS, модель сможет менять и удалять данные сервиса
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/mcp-graphqlОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Агент отправляет произвольные запросы к вашему API с заголовками авторизации из конфига
- Если включить ALLOW_MUTATIONS, модель сможет менять и удалять данные сервиса
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
mcp-graphql подключает агента к любому GraphQL-эндпоинту. Схему сервер получает сам, через introspection-запрос, из локального файла или по ссылке, поэтому агент видит, какие типы и поля есть у API, и составляет запросы под них. Инструментов два. introspect-schema возвращает схему, query-graphql отправляет запрос на эндпоинт. Клиенты MCP, которые читают ресурсы, получают схему еще и как ресурс graphql-schema. Сервер настраивают переменными окружения: адрес эндпоинта, заголовки запросов, путь к файлу схемы и имя сервера. Мутации по умолчанию выключены, чтобы модель не изменила данные в вашем сервисе, и включаются отдельной переменной.
Для кого. Для разработчиков, которые отлаживают или исследуют GraphQL API вместе с агентом в Claude Desktop, Claude Code или Cursor.
Подходит, если
- Нужно быстро выяснить, какие запросы и типы есть у чужого GraphQL API, не открывая его документацию
- Агент пишет клиентский код под ваш GraphQL-бэкенд и должен сверять поля со схемой
- Вы разрабатываете GraphQL-сервер на localhost и хотите проверять запросы прямо из диалога
- Схема лежит файлом или по ссылке, а introspection на сервере недоступна
- Нужно собрать прототип интеграции, где агент читает данные API на лету
Не подходит, если
- Нужен доступ к базе данных напрямую: сервер работает только с GraphQL-эндпоинтом
- Агенту нужно разрешить только несколько заранее выбранных операций: здесь модель может отправить любой запрос
- API работает по REST или gRPC, GraphQL там нет
- Нужна интеграция для рабочей системы с ограничением полей, лимитами и аудитом запросов
Пример запроса к агенту
Подключись к GraphQL API на localhost:3000, покажи, какие запросы есть в схеме, и получи список последних десяти заказов.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
ENDPOINTобязательная- Адрес GraphQL-эндпоинта, по умолчанию http://localhost:4000/graphql
HEADERSсекрет- Строка JSON с заголовками запросов, например с токеном авторизации
ALLOW_MUTATIONS- Значение true включает мутации, по умолчанию они выключены
SCHEMA- Путь к файлу схемы GraphQL или ссылка на него вместо introspection
NAME- Имя MCP-сервера, по умолчанию mcp-graphql
Ограничения
Сервер универсальный: он не ограничивает, какие поля и запросы доступны модели. В примере из документации токен передается строкой в переменной HEADERS, то есть секрет оказывается в файле настроек клиента.
Репозиторий обновлялся в последний раз в сентябре 2025 года. Интерактивного входа нет: доступ задается только заголовками из HEADERS, поэтому токен для API с логином через браузер придется получить отдельно.
Как отключить. Удалите запись mcp-graphql из конфигурации клиента MCP и перезапустите клиент. Если ставили через Smithery, уберите сервер и в настройках этого клиента. Ключей и фоновых процессов сервер не оставляет.
Частые вопросы
Как поставить mcp-graphql в Claude Desktop?
Автор дает два пути. Первый: команда npx -y @smithery/cli install mcp-graphql --client claude через Smithery. Второй: запись в конфиг с командой npx, аргументом mcp-graphql и переменной ENDPOINT в блоке env. Других клиентов в инструкции нет, но запуск обычный, через stdio.
Как передать токен авторизации для GraphQL API?
Через переменную HEADERS: это строка JSON с заголовками запросов, например с полем Authorization. Заголовки уходят с каждым запросом агента, поэтому давайте токен с минимальными правами.
Можно ли обойтись без introspection-запроса?
Да. Переменная SCHEMA принимает путь к локальному файлу схемы или ссылку на файл. Тогда инструмент introspect-schema возвращает схему оттуда, а не с эндпоинта.
Почему после обновления до 1.0.0 перестали работать старые настройки?
С версии 1.0.0 аргументы командной строки заменены переменными окружения. Перенесите адрес, заголовки и остальное в блок env.
Какая лицензия у mcp-graphql и на чем он написан?
Проект распространяется по лицензии MIT, исходный код на TypeScript. Пакет называется mcp-graphql, команда запуска у него тоже mcp-graphql.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер Apollo: превращает заданные операции GraphQL в инструменты, через которые агент работает с вашим API
MCP-сервер для PostgreSQL с подбором индексов, планами EXPLAIN, проверкой здоровья базы и режимом только чтения
Пакет для Laravel и Lumen, который добавляет MCP-эндпоинт в маршруты приложения и подключает к нему ваши инструменты
Мгновенный REST и MCP поверх PostgreSQL: агент читает данные существующей базы через MCP-эндпоинт без написания бэкенда
Два официальных MCP-сервера Prisma: локальный для миграций и Prisma Studio и удаленный для управления базами Prisma Postgres
Официальный MCP-сервер Supabase: агент управляет таблицами, читает конфигурацию и данные проектов после входа через OAuth
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| mcp-graphql — MCP-сервер для GraphQL API (эта запись) | нет | не нужна | 407 | |
| Apollo MCP Server | да | не нужна | 317 | превращает заранее заданные операции GraphQL в отдельные инструменты, поэтому набор запросов ограничен |
| GraphJin MCP | да | не нужна | 3 225 | дает агенту доступ к базам SQL и MongoDB, тогда как mcp-graphql работает с готовым GraphQL-эндпоинтом |
Коротко о README
Репозиторий описывает установку через Smithery и ручную запись в конфиг, а затем показывает запуск с локальным сервером, заголовками, файлом схемы и схемой по ссылке. Автор предупреждает, что реализация общая, и для рабочей системы советует собрать собственный узкий MCP-сервер, взяв этот проект за образец.