Jules MCP Server

Jules MCP Server — независимый community-проект savethepolarbears, который связывает MCP-клиент с API Google Jules. Локальный Node.js-процесс создаёт и контролирует coding sessions, читает их состояние и активности, а также ведёт собственные расписания. Google не создавал, не поддерживает и не одобрял этот сервер.

Как устроено подключение

MCP-клиент запускает собранный файл dist/index.js как дочерний процесс и обменивается с ним сообщениями через stdio. Сервер обращается к Jules API по ключу пользователя. Удалённого HTTP- или SSE-endpoint в текущей реализации нет: HTTP упомянут только как долгосрочный план.

Установка из исходников

Публичный npm registry не находил пакет @google/jules-mcp-server на 8 августа 2026 года. Поэтому не используйте команду npx @google/jules-mcp-server: клонируйте проверенный репозиторий, установите зависимости и соберите проект.

git clone https://github.com/savethepolarbears/jules-mcp-server.git
cd jules-mcp-server
npm install
npm run build

После сборки укажите абсолютный путь к dist/index.js в конфигурации MCP-клиента. Перед обновлением просмотрите новый commit и lock-файл, затем повторите установку зависимостей и сборку.

Пример конфигурации MCP-клиента

{
  "mcpServers": {
    "jules-community": {
      "command": "node",
      "args": ["/absolute/path/jules-mcp-server/dist/index.js"],
      "env": {
        "JULES_API_KEY": "<secret>",
        "JULES_ENCRYPTION_KEY": "<random-secret>",
        "JULES_ALLOWED_REPOS": "owner/repository",
        "JULES_DEFAULT_BRANCH": "main"
      }
    }
  }
}

Синтаксис оболочки конфигурации зависит от клиента, но команда запуска остаётся локальной: node и абсолютный путь к собранному файлу. Не храните рабочий API key в репозитории или общем примере.

Переменные окружения

Инструменты сервера

В проверенном src/index.ts зарегистрировано 11 tools. Их полезно разделять по последствиям: часть только читает состояние, а часть создаёт задачи, одобряет планы, меняет расписания или отменяет работу.

Recurring scheduling — надстройка этого репозитория, а не подтверждённая функция Jules API v1alpha. Расписание и его история хранятся локально; они не обязаны появляться в веб-интерфейсе Jules.

Resources и локальные данные

MCP resources дают клиенту данные о подключённых repositories, sessions, полных активностях, diff, расписаниях и истории запусков. Репозиторий заявляет AES-256-GCM для файла ~/.jules-mcp/schedules.enc, права каталогов и файлов 0700/0600 и очистку ошибок API. Это описание разработчика, а не результат независимого аудита; реальное применение прав и защита файла зависят от операционной системы и конфигурации.

Риски и безопасная конфигурация

Ключ Jules даёт серверу возможность запускать действия, связанные с доступными источниками и репозиториями. Локальный процесс также может выполнять повторяющиеся задания после перезапуска. Подключайте его только к доверенному MCP-клиенту и начинайте с отдельного тестового репозитория.

1. Задайте JULES_ALLOWED_REPOS явным списком. Если переменная отсутствует или пуста, текущий RepositoryValidator разрешает все repositories, доступные через Jules source.
2. Передавайте JULES_API_KEY и JULES_ENCRYPTION_KEY через секреты окружения, не через отслеживаемый конфигурационный файл.
3. Требуйте ручного просмотра плана до выполнения изменений и обычного code review перед merge pull request.
4. Проверяйте repository, branch и текст задания перед созданием каждой coding session.
5. Просматривайте список schedules после настройки и удаляйте ненужные повторяющиеся задачи.
6. После компрометации устройства или логов отзовите API key и замените ключ шифрования; старый локальный файл расписаний оцените отдельно.

Лицензия, версия и активность

Код распространяется по MIT License с условием «as is» и без гарантий. Последний проверенный commit d9ca707 датирован 10 июля 2026 года и обновляет зависимости и verification steps; metadata репозитория указывала обновление 27 июля. Это признак недавней активности на дату проверки, но не обещание поддержки или SLA.

В репозитории не обнаружены Git tags. package.json содержит версию 1.0.0, а changelog упоминает 1.1.0, поэтому карточка не называет текущую релизную версию. Перед установкой фиксируйте конкретный commit и проверяйте изменения самостоятельно.

Кому подходит этот MCP-сервер

Проект подходит разработчику, который уже использует Google Jules, готов собирать Node.js-приложение из исходников и хочет управлять сессиями из MCP-клиента. Для команды, которой нужен официальный сервер Google, hosted endpoint, опубликованный npm-пакет или независимо проверенная модель безопасности, этот community-проект не закрывает требования.