mcp-graphql-enhanced — MCP-сервер для Claude Code: обзор и запуск
Шлюз GraphQL для языковых моделей, защищающий от ошибок переполнения контекста при разборе больших схем. Помогает точечно опрашивать графы и объединять API.
claude mcp add --env ENDPOINT=<ENDPOINT> --env HEADERS=<HEADERS> --env ALLOW_MUTATIONS=<ALLOW_MUTATIONS> --env NAME=<NAME> --env SCHEMA=<SCHEMA> --transport stdio mcp-graphql-enhanced -- npx -y @letoribo/mcp-graphql-enhancedЧто делает mcp-graphql-enhanced
Стандартная интроспекция часто приводит к ошибке превышения размера ответа, когда схема насчитывает сотни типов вроде графов GitHub или Neo4j. Сервер решает эту проблему за счёт выборочного исследования схемы: параметры typeNames и typeDepth ограничивают глубину и список запрашиваемых сущностей, сохраняя контекстное окно модели чистым.
Шлюз поддерживает переключение целевых адресов в рантайме внутри инструментов query-graphql и introspect-schema, а также передачу заголовков авторизации без перезапуска процесса. Несколько независимых сервисов можно объединить через список URL через запятую, после чего сервер распределит запросы и объединит данные.
По умолчанию любые мутации заблокированы ради безопасности данных. Для выполнения модифицирующих запросов придётся явно задать переменную окружения ALLOW_MUTATIONS.
Какие задачи решает
- ограничить объём интроспекции через параметры
typeNamesиtypeDepth - выполнять GraphQL-запросы к разным сервисам без перезапуска сервера
- объединять несколько независимых источников GraphQL в единую федерацию
- передавать динамические заголовки авторизации прямо в параметрах вызова
Примеры запросов агенту
- Запроси схему сущностей
UserиRepositoryс глубиной вложенности 2 черезintrospect-schema - Выполни GraphQL-запрос через
query-graphql, передав токен в аргументе с заголовкомAuthorization - Проверь типы данных во внешнем графе, переключив параметр
endpointв аргументахquery-graphql
Как установить mcp-graphql-enhanced
Командой платформы
claude mcp add --env ENDPOINT=<ENDPOINT> --env HEADERS=<HEADERS> --env ALLOW_MUTATIONS=<ALLOW_MUTATIONS> --env NAME=<NAME> --env SCHEMA=<SCHEMA> --transport stdio mcp-graphql-enhanced -- npx -y @letoribo/mcp-graphql-enhancedВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Командой платформы
codex mcp add mcp-graphql-enhanced --env ENDPOINT=<ENDPOINT> --env HEADERS=<HEADERS> --env ALLOW_MUTATIONS=<ALLOW_MUTATIONS> --env NAME=<NAME> --env SCHEMA=<SCHEMA> -- npx -y @letoribo/mcp-graphql-enhancedВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Файл настроек
{
"mcpServers": {
"mcp-graphql-enhanced": {
"command": "npx",
"args": [
"-y",
"@letoribo/mcp-graphql-enhanced"
],
"env": {
"ENDPOINT": "<ENDPOINT>",
"HEADERS": "<HEADERS>",
"ALLOW_MUTATIONS": "<ALLOW_MUTATIONS>",
"NAME": "<NAME>",
"SCHEMA": "<SCHEMA>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Файл настроек
{
"servers": {
"mcp-graphql-enhanced": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@letoribo/mcp-graphql-enhanced"
],
"env": {
"ENDPOINT": "<ENDPOINT>",
"HEADERS": "<HEADERS>",
"ALLOW_MUTATIONS": "<ALLOW_MUTATIONS>",
"NAME": "<NAME>",
"SCHEMA": "<SCHEMA>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Командой платформы
gemini mcp add -e ENDPOINT=<ENDPOINT> -e HEADERS=<HEADERS> -e ALLOW_MUTATIONS=<ALLOW_MUTATIONS> -e NAME=<NAME> -e SCHEMA=<SCHEMA> mcp-graphql-enhanced npx -y @letoribo/mcp-graphql-enhancedВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-graphql-enhanced
Как установить mcp-graphql-enhanced в Claude Code?
Выполните команду claude mcp add mcp-graphql-enhanced -- npx -y @letoribo/mcp-graphql-enhanced.
Зачем нужен mcp-graphql-enhanced?
Сервер предотвращает сбои из-за превышения лимитов контекста при чтении объёмных схем GraphQL. Он позволяет запрашивать отдельные узлы и контролировать глубину вложенности.
Разрешены ли мутации по умолчанию?
Мутации отключены в исходной конфигурации для защиты от случайных изменений. Чтобы их разрешить, нужно передать переменную окружения ALLOW_MUTATIONS.
