Сервер протокола контекста модели схемы GraphQL

значок кузнеца Сервер Model Context Protocol (MCP), который предоставляет информацию о схеме GraphQL для больших языковых моделей (LLM), таких как Claude. Этот сервер позволяет LLM исследовать и понимать схемы GraphQL с помощью набора специализированных инструментов.

Функции

Загрузите любой файл схемы GraphQL, указанный через аргумент командной строки.
Изучите поля запросов, мутаций и подписок
Посмотрите подробные определения типов
Поиск типов и полей с использованием сопоставления с образцом
Получите упрощенную информацию о поле, включая типы и аргументы
Отфильтруйте внутренние типы GraphQL для получения более чистых результатов

Related MCP server: mcp-openapi-schema

Использование

Командная строка

Запустите сервер MCP с определенным файлом схемы:

# Use the default schema.graphqls in current directory npx -y mcp-graphql-schema # Use a specific schema file (relative path) npx -y mcp-graphql-schema ../schema.shopify.2025-01.graphqls # Use a specific schema file (absolute path) npx -y mcp-graphql-schema /absolute/path/to/schema.graphqls # Show help npx -y mcp-graphql-schema --help

Установка через Smithery

Чтобы автоматически установить схему GraphQL для Claude Desktop через Smithery :

npx -y @smithery/cli install @hannesj/mcp-graphql-schema --client claude

Интеграция рабочего стола Клода

Чтобы использовать этот сервер MCP с Claude Desktop, отредактируйте файл конфигурации claude_desktop_config.json :

{ "mcpServers": { "GraphQL Schema": { "command": "npx", "args": ["-y", "mcp-graphql-schema", "/ABSOLUTE/PATH/TO/schema.graphqls"] } } }

Расположение файла конфигурации:

macOS/Linux: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: $env:AppData\Claude\claude_desktop_config.json

Интеграция кода Клода

Чтобы использовать этот сервер MCP с Claude Code CLI, выполните следующие действия:

Добавьте сервер GraphQL Schema MCP в Claude Code
# Basic syntax claude mcp add graphql-schema npx -y mcp-graphql-schema # Example with specific schema claude mcp add shopify-graphql-schema npx -y mcp-graphql-schema ~/Projects/work/schema.shopify.2025-01.graphqls
Убедитесь, что сервер MCP зарегистрирован
# List all configured servers claude mcp list # Get details for your GraphQL schema server claude mcp get graphql-schema
Удалите сервер, если необходимо.
claude mcp remove graphql-schema
Используйте инструмент в Claude Code
После настройки вы можете вызывать инструмент в сеансе Claude Code, задавая вопросы о схеме GraphQL.

Советы:

Используйте флаг -s или --scope с project (по умолчанию) или global , чтобы указать, где хранится конфигурация.
Добавьте несколько серверов MCP для разных схем с разными именами (например, основная схема API, схема Shopify)

Инструменты МКП

Сервер предоставляет следующие инструменты для взаимодействия LLM со схемами GraphQL:

list-query-fields : список всех доступных полей корневого уровня для запросов GraphQL
get-query-field : Получает подробное определение для определенного поля запроса в формате SDL
list-mutation-fields : список всех доступных полей корневого уровня для мутаций GraphQL
get-mutation-field : Получает подробное определение для конкретного поля мутации в формате SDL
list-subscription-fields : выводит список всех доступных полей корневого уровня для подписок GraphQL (если они присутствуют в схеме)
get-subscription-field : Получает подробное определение для определенного поля подписки (если присутствует в схеме)
list-types : Перечисляет все типы, определенные в схеме GraphQL (исключая внутренние типы)
get-type : Получает подробное определение для определенного типа GraphQL в формате SDL.
get-type-fields : получает упрощенный список полей с их типами для определенного типа объекта GraphQL.
search-schema : Поиск типов или полей в схеме по шаблону имени (регулярное выражение без учета регистра)

Примеры

Примеры запросов, которые стоит попробовать:

What query fields are available in this GraphQL schema? Show me the details of the "user" query field. What mutation operations can I perform in this schema? List all types defined in this schema. Show me the definition of the "Product" type. List all fields of the "Order" type. Search for types and fields related to "customer".