mcp-graphql

значок кузнеца

Сервер Model Context Protocol, который позволяет LLM взаимодействовать с API GraphQL. Эта реализация обеспечивает возможности интроспекции схемы и выполнения запросов, позволяя моделям динамически обнаруживать и использовать API GraphQL.

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

Запустите mcp-graphql с правильной конечной точкой, он автоматически попытается проанализировать ваши запросы.

Переменные среды (критическое изменение в версии 1.0.0)

Примечание: Начиная с версии 1.0.0 аргументы командной строки заменены переменными среды.

Переменная среды	Описание	По умолчанию
`ENDPOINT`	URL-адрес конечной точки GraphQL	`http://localhost:4000/graphql`
`HEADERS`	Строка JSON, содержащая заголовки для запросов	`{}`
`ALLOW_MUTATIONS`	Включить операции мутации (по умолчанию отключено)	`false`
`NAME`	Имя MCP-сервера	`mcp-graphql`
`SCHEMA`	Путь к локальному файлу схемы GraphQL (необязательно)	-

Примеры

# Basic usage with a local GraphQL server
ENDPOINT=http://localhost:3000/graphql npx mcp-graphql

# Using with custom headers
ENDPOINT=https://api.example.com/graphql HEADERS='{"Authorization":"Bearer token123"}' npx mcp-graphql

# Enable mutation operations
ENDPOINT=http://localhost:3000/graphql ALLOW_MUTATIONS=true npx mcp-graphql

# Using a local schema file instead of introspection
ENDPOINT=http://localhost:3000/graphql SCHEMA=./schema.graphql npx mcp-graphql

Related MCP server: mcp-graphql-schema

Ресурсы

graphql-schema : Сервер выставляет схему GraphQL как ресурс, к которому клиенты могут получить доступ. Это либо локальный файл схемы, либо основанный на запросе интроспекции.

Доступные инструменты

Сервер предоставляет два основных инструмента:

introspect-schema : Этот инструмент извлекает схему GraphQL. Используйте его в первую очередь, если у вас нет доступа к схеме как к ресурсу. Он использует либо локальный файл схемы, либо запрос интроспекции.
query-graphql : Выполнение запросов GraphQL к конечной точке. По умолчанию мутации отключены, если ALLOW_MUTATIONS не установлен в true .

Установка

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

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

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

Установка вручную

Его можно вручную установить на Клода:

{
    "mcpServers": {
        "mcp-graphql": {
            "command": "npx",
            "args": ["mcp-graphql"],
            "env": {
                "ENDPOINT": "http://localhost:3000/graphql"
            }
        }
    }
}

Соображения безопасности

Мутации отключены по умолчанию в качестве меры безопасности, чтобы не дать LLM изменить вашу базу данных или данные сервиса. Тщательно подумайте, прежде чем включать мутации в производственных средах.

Настройте под свой сервер

Это очень общая реализация, которая позволяет проводить полную интроспекцию и делать что угодно для ваших пользователей (включая мутации). Если вам нужна более конкретная реализация, я бы предложил просто создать свой собственный MCP и заблокировать вызов инструмента для клиентов, чтобы они вводили только определенные поля запроса и/или переменные. Вы можете использовать это в качестве справочного материала.