mcp-graphql
Сервер Model Context Protocol, который позволяет LLM взаимодействовать с API GraphQL. Эта реализация обеспечивает возможности интроспекции схемы и выполнения запросов, позволяя моделям динамически обнаруживать и использовать API GraphQL.
Использование
Запустите mcp-graphql с правильной конечной точкой, он автоматически попытается проанализировать ваши запросы.
Переменные среды (критическое изменение в версии 1.0.0)
Примечание: Начиная с версии 1.0.0 аргументы командной строки заменены переменными среды.
Переменная среды | Описание | По умолчанию |
| URL-адрес конечной точки GraphQL |
|
| Строка JSON, содержащая заголовки для запросов |
|
| Включить операции мутации (по умолчанию отключено) |
|
| Имя 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 :
Установка вручную
Его можно вручную установить на Клода:
Соображения безопасности
Мутации отключены по умолчанию в качестве меры безопасности, чтобы не дать LLM изменить вашу базу данных или данные сервиса. Тщательно подумайте, прежде чем включать мутации в производственных средах.
Настройте под свой сервер
Это очень общая реализация, которая позволяет проводить полную интроспекцию и делать что угодно для ваших пользователей (включая мутации). Если вам нужна более конкретная реализация, я бы предложил просто создать свой собственный MCP и заблокировать вызов инструмента для клиентов, чтобы они вводили только определенные поля запроса и/или переменные. Вы можете использовать это в качестве справочного материала.