Apollo MCP Server

Apollo MCP Server

apollographqlMIT
284 звёзд67 форков
Apollo MCP Server — это проект от создателей Apollo GraphQL. Он реализует протокол MCP (Model Context Protocol) и открывает ваши GraphQL-данные для языковых моделей. Если у вас уже есть API на Apollo, сервер превращает его в набор инструментов для AI-ассистентов. Разработчикам не нужно дублировать логику или писать промпты для каждой сущности. Сервер сам разбирает GraphQL-схему, находит запросы и мутации, которые вы указали в конфигурации, и экспортирует их как MCP-инструменты. Ассистент вроде Claude получает прямой доступ к данным — может искать пользователей, создавать заказы или обновлять записи без ручного написания HTTP-запросов. Сервер написан на Rust и работает по протоколу stdio. Это значит, что он запускается вместе с клиентом MCP и не требует отдельного сервера. Вся настройка сводится к указанию конфигурационного файла. Apollo MCP Server подходит для проектов, которые уже используют Apollo GraphQL и хотят добавить AI-функциональность без перестройки архитектуры.
Ai-ml
Открыть на GitHubОфициальный сайт

Характеристики

Общее

  • СтатусСообщество
  • Разработчикapollographql
  • ЛицензияMIT

Технологии

  • Языки
    Rust
  • Транспорт
    stdio

Описание

Возможности

  • Превращает любые GraphQL-запросы (Query) и мутации (Mutation) в MCP-инструменты.
  • Даёт AI-моделям выполнять произвольные операции с данными напрямую.
  • Использует конфигурационный файл YAML для декларативного описания графа и доступных операций.
  • Собирается из исходников на Rust без внешних зависимостей командой cargo build.
  • Работает с любыми GraphQL-схемами, включая федеративные схемы Apollo.
  • Даёт выполнять цепочки запросов: от поиска данных до их изменения в рамках одного разговора с AI.
  • Совместим с любыми MCP-клиентами: Claude Desktop, MCP Inspector и другими.

Как подключить

  1. Скачайте репозиторий и соберите сервер:

    git clone https://github.com/apollographql/apollo-mcp-server.git cd apollo-mcp-server cargo build

    Бинарный файл появится в папке target/debug. Если не хотите собирать — скачайте готовый бинарник на странице релизов проекта.

  2. Создайте файл конфигурации config.yaml. Укажите URL вашего GraphQL-графа и список операций, которые AI сможет использовать. Подробный синтаксис описан в документации Apollo MCP Server.

  3. Настройте подключение в MCP-клиенте. Для Claude Desktop отредактируйте файл claude_desktop_config.json:

    { "mcpServers": { "apollo": { "command": "/путь/к/apollo-mcp-server", "args": ["--config", "/путь/к/config.yaml"] } } }

  4. Перезапустите Claude Desktop. Сервер запустится автоматически при старте клиента.

Примеры запросов

  • «Найди пользователя с ID 5. Выполни запрос user(id: 5) и покажи имя, email и дату регистрации.»
  • «Создай новый продукт в каталоге. Выполни мутацию createProduct с названием «Смартфон», ценой 800 и категорией «Гаджеты».»
  • «Найди все заказы за последнюю неделю со статусом «Ожидание». Покажи их в виде таблицы.»
  • «Обнови email пользователя с ID 42 на new@address.com через мутацию updateUser. Подтверди выполнение.»

Технические детали

  • Язык: Rust
  • Транспорт: stdio
  • Лицензия: MIT
  • Разработчик: apollographql
  • Совместимые клиенты: Claude Desktop, MCP Inspector, любые MCP-клиенты

Поделиться