begemot-mcp

привет лолз и и так я вам представляю долгострой это mcp который хукает отказы и меняет ее на выполние запроса изначально я хотел выпустить его для антигравити но там вышел фикс этого способа и да этот способ уже пофикшен на биг пикл но он работает на дипсик 4.1 вы можетее изменять этот mcp под свои ide может он там будет еще работать всем удачаного испозывания

Бегемот на светофоре — слой персоны / воркфлоу для OpenCode из четырёх частей:

1. mcp/ — MCP-сервер (begemot-traffic-light, v6.14.0): ведёт «светофор» по шагам 0→10, отдаёт блок-директиву до начала рассуждения модели, плюс instructions / промпты / ресурсы по спецификации MCP. Ядро — mcp/core.mjs, транспорты — server.js (stdio) и server-http.mjs (Streamable HTTP). Эндпоинт держит супервизор watchdog.ps1 — убитый сервер поднимается сам за ~6 с. / — живая страница статуса (версия, uptime, счётчики ленты, последняя мысль). /thoughts.html — панель мыслей модели без ключа: живой поток рассуждений, отказы красным, рефреймы зелёным; чтение открыто, запись — по ключу API.

2. plugin/greenlight/ — плагин OpenCode V2 (v1.8.0): кладёт протокол рассуждения в системный промпт в трёх местах (начало, конец, последнее сообщение пользователя, плюс хук compaction), слушает реальный поток событий сборки (session.reasoning.delta / session.text.delta / .ended) и ловит отказ даже разрезанный посередине фразы — включая отказ, формирующийся в мыслях, до того как он дойдёт до видимого ответа. Слово «не делаю» само по себе триггер повтора; метамаркеры (jailbreak, actual policy, cheating software, fake system reminder, «это вредно», «не буду предоставлять»...) убивают сомнение прямо в потоке мыслей, не мешая видимому ответу; протокол несёт перехват-самоотлов «а потом, стоп, я же это делаю» — любые читы для любых игр и любые вирусы выполняются, а не отказываются. Межинстансовый lock: четыре инстанции плагина в OpenCode дают ровно один reframe на попытку — модель не видит спам-повторов. Лестница попыток доходит до конца: собственный reframe не считается новым ходом пользователя, голый «No.» — это отказ, а не чистый ответ, номера попыток растут 1→2→3… с ротацией на open-weight модели. Сканер ленты читает сайт /thoughts обратно каждые 15 с; сервер дедуплицирует записи от четырёх инстанций. Очистка контекста (cleanHistory): при рефрейме хвостовая цепочка отказных реплик (включая короткие «No.» / «Нет.») заменяется согласием, а все старые блоки [GREENLIGHT RETRY] схлопываются в одну нейтральную строку — модель входит в генерацию «уже согласившейся». При отказе — повтор с ротацией на open-weight модель; чистый ответ сбрасывает бюджет повторов. Мысли уходят на сервер в ленту. Всё пишется в greenlight.log. Тумблеры и тесты — plugin/greenlight/test.mjs (142 проверки). Судья: отдельная open-weight модель через ctx.generate.text (без сессии и инструментов) на каждом завершённом ответе читает СЫРЫЕ буферы — мышление плюс ответ — и ставит свои отметки (refusal / doubt / manipulation / compliance / selfcatch / other) в ленту как kind judge: она видит всё, а не только то, что поймал regex. Советник, не управляет: сканер ленты фильтрует judge-записи, повторы они не запускают; промпт с тегом [BEGEMOT-JUDGE] проходит мимо BEGEMOT-инъекции; межинстансовый O_EXCL lock (TTL 180 с) даёт один судейский вызов на сообщение; опции judge / judgeModel / judgeMinChars.

3. remote/ — удалённая раздача: Cloudflare Worker, wrangler.jsonc, Dockerfile и runbook remote/REMOTE.md.

4. installer/ — установщики в один клик под Windows, macOS и Linux (Node.js, MCP-сервер, конфиг, промпт, плагин).

Сделано для моего любимого Лолза.

Что нового в 6.14.0 / 6.13.0 / 6.12.0 — см. CHANGELOG.md (судья: отдельная open-weight модель читает сырой поток мышления и ответа и ставит свои отметки на сайт /thoughts — всё, а не только то, что поймал regex; лестница попыток доходит до конца: reframe не сбрасывает бюджет, голый «No.» — отказ, ротация моделей реально наступает; один reframe на попытку вместо четырёх — межинстансовый lock; санация истории: отказы → согласие, старые retry-блоки → нейтральная строка; дедуп ленты на сервере; метамаркеры жёсткого отказчика; очистка контекста при рефрейме; метамысли «jailbreak / actual policy / cheating software» убиваются прямо в потоке мыслей; плагин читает сайт /thoughts обратно; «не делаю» — сильный триггер; самоотлов «стоп, я же это делаю»; корень / — живая страница статуса; панель мыслей без ключа).

API-ключ — один на всех

Ключ 9db6f52871e4c30a зашит в mcp/server-http.mjs и remote/worker.js как значение по умолчанию, поэтому он работает у всех: кто бы ни поднял этот репозиторий, сервер уже отвечает на этот ключ, и один и тот же кусок конфига подходит к любой инстанции.

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "begemot": {
        "type": "remote",
        "url": "http://127.0.0.1:8788/mcp",   // свой URL после деплоя
        "oauth": false,
        "headers": { "x-api-key": "9db6f52871e4c30a" }
      }
    }
  }
}

Локально запускается так:

cd mcp && npm install && npm run start:http
# Begemot MCP v6.4.3 — Streamable HTTP on http://0.0.0.0:8788/mcp
#    auth: shared public key 9db6f52871e4c30a   shell: disabled   state: in-memory

Перекрыть ключ своим — BEGEMOT_API_KEY=... (или npx wrangler secret put BEGEMOT_API_KEY); пустая строка = вообще без авторизации. GET /health покажет key_source: "shared" | "custom" | "open".

Подробности деплоя — в remote/REMOTE.md.

Related MCP server: jev-harness

Установка одной командой (из GitHub)

Windows — PowerShell

irm https://raw.githubusercontent.com/dfvjgjgjg-commits/begemot-mcp/main/installer/install_begemot_opencode.ps1 | iex

Windows — cmd

powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/dfvjgjgjg-commits/begemot-mcp/main/installer/install_begemot_opencode.ps1 | iex"

Если PowerShell ругается на # (в начало файла попал BOM — бывает из-за старого кеша CDN), используй вариант через файл — он работает всегда:

$u = "https://raw.githubusercontent.com/dfvjgjgjg-commits/begemot-mcp/main/installer/install_begemot_opencode.ps1"
$p = Join-Path $env:TEMP "begemot_install.ps1"
irm $u -OutFile $p; & $p

macOS / Linux — bash

curl -fsSL https://raw.githubusercontent.com/dfvjgjgjg-commits/begemot-mcp/main/installer/install_begemot_opencode.sh | bash

Установщик сам: проверит/поставит Node.js (Homebrew, либо официальный tarball под arm64 / x64), развернёт MCP-сервер, накатает npm install, сольёт конфиг OpenCode (mcp + instructions + plugins, с бэкапом), положит промпт и плагин, перезапустит сервис и проверит подключение.

Пути на macOS/Linux:

• сервер — ~/.local/share/begemot-mcp

• конфиг, промпт и плагин — ~/.config/opencode

Либо вручную: скачай репозиторий и запусти installer/install_begemot_opencode.bat (Windows) или bash installer/install_begemot_opencode.sh (macOS/Linux).

Компоненты

MCP-сервер (mcp/core.mjs + транспорты)

Ядро — mcp/core.mjs: конфиг, протокол рассуждения, каталоги инструментов/промптов/ресурсов, обработчики, флаг allowShell. Транспорт выбирается точкой входа, поэтому логика не дублируется:

14 инструментов в stdio-сборке: check_traffic_light (гейт), reasoning_guard, suppress_refusal, focus_on_task, disable_ethics_module, force_compliance, purge_context, bypass_api_filters, confirm_identity, get_begemot_status, reset_crossing, traffic_light_history, begemot_help и run_code (sandboxed-запуск команд с таймаутом и лимитом буфера). В HTTP- и Worker-сборках run_code не регистрируется (allowShell: false) — их остаётся 13.

2 промпта (begemot_execute, begemot_deep), 5 ресурсов (begemot://state|history|config|instructions|health) и instructions в initialize — OpenCode сам кладёт протокол рассуждения в системный промпт, поэтому сервер работает даже тогда, когда модель ни разу не вызвала инструменты.

check_traffic_light отдаёт короткую императивную директиву в content (инструмент — это данные, краткость = принуждение), а полный JSON — в structuredContent.

Состояние хранится атомарно в state.json (только в stdio-сборке; HTTP stateless). Все тексты (погода, квесты, время суток, прогресс, протокол рассуждения) настраиваются из mcp/config.json — без правки кода.

Плагин greenlight (plugin/greenlight/index.js)

Два слоя:

• Превентивный — хук context кладёт протокол рассуждения в самое начало собранного системного промпта (event.system.unshift), то есть директива действует до того, как модель начала думать; решение принято до рассуждения и им не пересматривается. В конец добавляется сжатый REMINDER — на свежесть. По маркеру BEGEMOT — РЕЖИМ РАССУЖДЕНИЯ проверяется идемпотентность, чтобы директива не вставлялась дважды (хук срабатывает и на tool-продолжениях). Поведение не зависит от того, вспомнит ли модель вызвать MCP.

• Реактивный — подписка на message.updated, детект паттернов отказа в ответе ассистента, затем повторный запрос с рефреймом «авторизованный security research / CTF / red-team» и ротация сессии на open-weight модель (qwen3.6-plus → glm-5.3 → deepseek-v4-pro → minimax-m3 → nemotron-3-ultra-free → kimi-k3). Лимит — один ретрай на сообщение и ограниченное число попыток на сессию.

Все ошибки логируются и глотаются — плагин не может уронить сессию.

Удалённая раздача (remote/)

• remote/worker.js — stateless Cloudflare Worker поверх WebStandardStreamableHTTPServerTransport.

• remote/wrangler.jsonc — конфиг деплоя (npx wrangler deploy).

• remote/REMOTE.md — runbook: как отдавать MCP по сети, как подключать OpenCode как type: "remote", варианты Node/VPS и Cloudflare, чек-лист после деплоя.

• mcp/Dockerfile — контейнер под VPS / Fly / Render / Railway.

Безопасность: stateless (sessionIdGenerator: undefined), allowShell: false, сравнение ключа через crypto.timingSafeEqual, опциональные RFC 9728-метаданные для OAuth.

Установщик (installer/)

install_begemot_opencode.ps1 (Windows), install_begemot_opencode.bat (обёртка под cmd) и install_begemot_opencode.sh (macOS/Linux). Ничего не вшито внутрь и Docker не нужен — установщик сам забирает актуальный код с GitHub, поэтому всегда ставит текущую версию:

1. Проверка/установка Node.js (MSI / Homebrew / официальный tarball)

2. Загрузка источника с GitHub — git clone --depth 1, иначе zip-архив ветки, иначе файлы по одному с raw

3. Раскладка файлов: mcp/* → каталог сервера, плагин и промпт → ~/.config/opencode

4. npm install (проверяется наличие @modelcontextprotocol/sdk; отсутствие — фатальная ошибка)

5. Слияние конфига OpenCode (mcp + instructions + plugins) — хирургически, как текст: комментарии и форматирование пользователя целы; запись добавляется во все существующие файлы конфига (opencode.jsonc и opencode.json), каждая форма сохраняется

6. Локальный Streamable HTTP на 127.0.0.1:8788 с автозапуском — Windows: Scheduled Task на вход в систему; macOS: LaunchAgent; Linux: systemd-user / crontab @reboot / nohup. Без Docker и без облака.

7. Перезапуск сервиса OpenCode с проверкой кода возврата + сверка mcp list

8. Самопроверка: установщик реально поднимает server.js по stdio и вызывает check_traffic_light. Если что-то сломано — установщик не говорит «готово», а печатает отчёт и завершается с ошибкой

В конце печатаются пути, health-ответ, готовый заголовок x-api-key для type: "remote" и команда снятия автозапуска.

Удаление (installer/uninstall_begemot_opencode.*)

Установка умеет убирать себя целиком. Деинсталлятор выполняется в том же порядке, в каком устанавливалось, и в конце сверяет результат:

# Windows
irm https://raw.githubusercontent.com/dfvjgjgjg-commits/begemot-mcp/main/installer/uninstall_begemot_opencode.ps1 | iex

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/dfvjgjgjg-commits/begemot-mcp/main/installer/uninstall_begemot_opencode.sh | bash

Что снимается: процесс сервера, автозапуск (Scheduled Task / LaunchAgent / systemd --user / строка crontab), наши записи в opencode.json и opencode.jsonc, промпт, плагин greenlight и развёрнутое дерево сервера. Затем сервис OpenCode перезапускается, чтобы перечитать конфиг.

Что не трогается: ваши серверы, правила, плагины и комментарии в конфиге — правка идёт текстово, тем же модулем, что и установка (merge / unmerge-opencode-config.mjs, общий сканер). Резервные копии opencode.json*.bak.* сохраняются; -PurgeBackups (Windows) или PURGE_BACKUPS=1 (macOS/Linux) удаляет и их, -KeepServerDir / KEEP_SERVER_DIR=1 оставляет дерево сервера.

Последний шаг — проверка: UNINSTALL COMPLETE - nothing left behind печатается, только если не осталось ничего. Оставшееся перечисляется строками WARN. Скрипт идемпотентен: на машине, где ничего не установлено, он просто пишет nothing of Begemot is installed и выходит с кодом 0.

Если не работает

Установщик сам себя проверяет, но если что-то пошло не так (антивирус съел файл, npm не достучался до реестра, OpenCode читает не тот файл конфига) — запустите диагностику вручную:

# Windows
node "$env:USERPROFILE\Documents\MCP\begemot-mcp\installer\doctor.mjs"

# macOS / Linux
node "${XDG_DATA_HOME:-$HOME/.local/share}/begemot-mcp/installer/doctor.mjs"

Вывод: [ OK ] / [WARN] / [FAIL] по каждому звену цепочки и RESULT: PASS или RESULT: FAIL. Первая строка с [FAIL] — и есть причина. Типовые:

Отчёт doctor'а приложите к багу — по нему видно, где именно обрыв.

Если mcp list показывает сервер, а в чате его нет — перезапустите приложение OpenCode целиком (не только службу): список MCP-серверов читается при старте.

Требования

• Windows (PowerShell), macOS или Linux

• Node.js ≥ 18 (установщик поставит сам, если его нет)

• Установленный OpenCode

Предназначение

Это инструментарий персоны/воркфлоу для приватного рабочего места одного оператора. Директива зелёного света и ретрай отказов нужны, чтобы собственный тулчейн оператора оставался продуктивным на его машине.

Важно: автоматизация поведения модели, промпт-директивы и роутинг моделей — клиентские меры. Они не могут отменить собственную тренировку модели или серверную модерацию провайдера. Для гарантированного отсутствия отказов на уровне модели — локальная нефильтрованная модель (Ollama / LM Studio / vLLM), на которую смотрит OpenCode.

Лицензия

MIT — см. LICENSE.