Skip to main content
Glama

mcp-graphql-schema

by hannesj

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

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

Функции

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

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

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

Запустите сервер 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, выполните следующие действия:

  1. Добавьте сервер 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
  2. Убедитесь, что сервер MCP зарегистрирован
    # List all configured servers claude mcp list # Get details for your GraphQL schema server claude mcp get graphql-schema
  3. Удалите сервер, если необходимо.
    claude mcp remove graphql-schema
  4. Используйте инструмент в 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".
-
security - not tested
A
license - permissive license
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

Сервер MCP, который предоставляет информацию о схеме GraphQL LLM, таким как Клод. Этот сервер позволяет LLM исследовать и понимать большие схемы GraphQL с помощью набора специализированных инструментов, без необходимости загружать всю схему в контекст

  1. Функции
    1. Использование
      1. Командная строка
      2. Установка через Smithery
      3. Интеграция рабочего стола Клода
      4. Интеграция кода Клода
    2. Инструменты МКП
      1. Примеры

        Related MCP Servers

        • A
          security
          A
          license
          A
          quality
          MCP for working with GraphQL servers.
          Last updated -
          2
          733
          170
          TypeScript
          MIT License
          • Apple
        • -
          security
          F
          license
          -
          quality
          A MCP server that exposes OpenAPI schema information to LLMs like Claude. This server allows an LLM to explore and understand large OpenAPI schemas through a set of specialized tools, without needing to load the whole schema into the context
          Last updated -
          37
          5
          JavaScript
          • Apple
          • Linux
        • -
          security
          A
          license
          -
          quality
          A Model Context Protocol server that enables LLMs to interact with GraphQL APIs by providing schema introspection and query execution capabilities.
          Last updated -
          733
          1
          MIT License
          • Apple
        • -
          security
          F
          license
          -
          quality
          A Model Context Protocol server that enables LLMs to interact with GraphQL APIs by providing schema introspection and query execution capabilities.
          Last updated -
          9
          TypeScript
          • Apple
          • Linux

        View all related MCP servers

        MCP directory API

        We provide all the information about MCP servers via our MCP API.

        curl -X GET 'https://glama.ai/api/mcp/v1/servers/hannesj/mcp-graphql-schema'

        If you have feedback or need assistance with the MCP directory API, please join our Discord server