Martin Loop

Martin Loop — MCP-сервер сообщества (автор — Keesan12). Система запуска, проверки и передачи работы агентов-программистов. Ставится через npx. Лицензия Apache-2.0.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
Keesan12
Лицензия
Apache-2.0
Транспорт
stdio
Авторизация
none
ОС
Не указана
Языки
typescript

Уровень риска: high

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

Настройка клиентов

codex
{
    "code": "codex mcp add martin-loop -- npx -y @martinloop/mcp",
    "lang": "bash",
    "notes": "Дословно из README",
    "verified": "docs"
}

Что умеет

MartinLoop — система управления запусками ИИ-агентов программиста. Код по-прежнему пишет агент, а MartinLoop держит задачу в рамках: задаёт цель и критерии готовности, ограничивает бюджет и число попыток, проверяет результат и фиксирует исход. Это позволяет давать агенту крупные задачи, не наблюдая за каждым шагом.

Жизненный цикл задачи по README: определение → предварительная проверка → контроль → проверка результата → восстановление → доказательство → анализ. Итог запуска — явный статус VERIFIED, STOPPED или NEEDS REVIEW с квитанцией.

Возможности:

  • бюджет: жёсткий потолок расходов в долларах (--budget-usd), токенов и попыток (--max-iterations); следующая попытка останавливается до превышения лимита;
  • проверка: задача засчитывается только после реальной проверки, например npm test; статус VERIFIED подтверждает лишь выполненные проверки, а не отсутствие ошибок;
  • политики: блокируют небезопасные команды проверки, рискованные изменения путей и похожие на секреты входные данные; можно задать разрешённые и запрещённые пути;
  • разбор сбоев: 13 классов ошибок выполнения, квитанции с причиной остановки, состоянием бюджета и следующим безопасным шагом; записи подписываются локально;
  • адаптеры: Claude CLI, Codex CLI, Gemini CLI и прямые адаптеры к моделям.

MCP-интеграция даёт клиенту одну точку запуска с правом записи, а также инструменты планирования, просмотра и проверки. MartinLoop не заменяет Git, CI, код-ревью или сканеры безопасности.

Кому подойдёт

  • Разработчикам и командам, которые поручают агентам большие задачи и хотят контролировать расходы и качество.
  • Тем, кто считает, сколько уходит на повторные попытки: команда audit показывает затраты Claude Code на циклы «исправить и повторить».

Похожие серверы — в категории разработка.

Установка

Запуск без установки или глобальная установка:

npm install -g martin-loop@latest

Начать можно с команд npx -y martin-loop@latest start (подключение) и npx -y martin-loop@latest demo (демонстрационное рабочее пространство). Если найдено несколько сред агентов, выберите нужную: npx -y martin-loop@latest enable --engine codex (или claude, gemini). Отдельный MCP-пакет запускается командой npx -y @martinloop/mcp, а martin mcp print-config выводит конфиг для нужного клиента. Корневой пакет, MCP-пакет и плагины выровнены на версии 0.9.0.

Подключение к клиентам

Команды приведены дословно из README. Подробнее — в инструкции как подключить MCP.

codex mcp add martin-loop -- npx -y @martinloop/mcp

В Windows README предлагает для Claude Code вариант с cmd /c npx -y @martinloop/mcp. Конфиг для Gemini CLI и других клиентов создаёт команда npx martin-loop mcp print-config с параметром --host.

Проверка

Создайте демонстрационное пространство и выполните запуск с проверкой и малым бюджетом:

npx -y martin-loop@latest run "Summarize the demo workspace and prove tests still pass" --verify "npm test" --budget-usd 2 --max-iterations 1

Затем посмотрите результат командой martin dossier --latest и проверьте целостность записей через martin runs verify --latest.

Примеры задач

Запусти задачу «исправить падающие тесты в модуле оплаты» с проверкой npm test, бюджетом 5 долларов и не более трёх попыток.
Покажи квитанцию последнего запуска: почему он остановился и что делать дальше.

Риски

  • Выполнение команд и правка кода. MartinLoop запускает агентов программиста и команды проверки, которые меняют файлы в рабочем пространстве. Задавайте разрешённые пути и работайте в ветке под контролем версий.
  • Расходы. Запуски агентов стоят денег у выбранного сервиса моделей. Всегда задавайте --budget-usd и --max-iterations; для Codex расход может быть только оценочным, если среда не сообщает точные данные.
  • Синхронизация. Работа локальная, но при настройке MARTIN_API_TOKEN и MARTIN_TELEMETRY_ENDPOINT доказательства запусков отправляются на панель. Храните токен в переменных окружения.
  • Границы проверки. Статус VERIFIED не означает, что код безопасен для слияния; ревью всё равно нужно.

Частые вопросы

Какую модель использует MartinLoop?

Ту, что указана в --model; без неё модель выбирает сама среда агента. Скрытой модели по умолчанию MartinLoop не подставляет.

Можно ли проверить затраты без отправки данных в сеть?

Да. Команда npx -y martin-loop@latest audit --offline работает без доступа к сети.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

GitHub MCP Server

Официальный MCP-сервер GitHub: репозитории, issues, пул-реквесты и Actions для ИИ-ассистента.

Риск: high Лицензия: MIT ★ 34 571

Git

Эталонный MCP-сервер для работы с локальными Git-репозиториями: чтение истории, поиск, просмотр изменений и коммиты.

Риск: high Лицензия: NOASSERTION ★ 92 089

GitDiagram

Архитектурные диаграммы, пояснения и исходники Mermaid для публичных репозиториев GitHub.

Риск: medium Лицензия: MIT ★ 18 997

git-mcp

Удалённый сервер, который отдаёт ИИ-ассистенту документацию любого репозитория или проекта на GitHub.

Риск: medium Лицензия: Apache-2.0 ★ 8 527

Источники