@autodevjapan/godd-mcp-alpha
v3.9.0
Published
Governed AI development workflows that turn natural-language intent into specifications, tested code, reviews, documentation, and shippable pull requests.
Readme
GoDD MCP α Server
🇺🇸 English | 🇯🇵 日本語 | 🇷🇺 Русский
English
Say what you want in plain language. GoDD runs the whole cycle — plan → implement → test → review → document → ship. It works inside Cursor, Claude Code, Codex, Kimi CLI, and Antigravity over the Model Context Protocol.
Why GoDD
- ~2,000–5,000 tokens per call instead of ~80,000+. Prompts are delivered on demand — only the one you invoke enters context. Always-on rule files burn your context window before you even type.
- Your AI stops guessing. Every prompt is built on seven proven xDD methodologies (Spec / Acceptance-Test / Test / Domain / Neo-Model / Docs / Issue-Driven Development), so it plans, tests, and documents like a senior engineer.
- One command does the whole job.
/dev,/review,/shipeach run a complete cycle — not a single step you have to babysit. - It knows your stack.
godd-a initprofiles your language, framework, and tooling, and delivered prompts adapt to it. - No migration. One server registers with every client you already use.
Install
npm install -g @autodevjapan/godd-mcp-alpha
godd-a install # auto-detect your MCP clients and register with each
godd-a init # generate a project profileThen type / in your client and pick a GoDD prompt — or just ask ("run dev", "do a review").
Requirements
Node.js 22+ · an MCP client (Cursor / Claude Code / Codex / Kimi CLI / Antigravity) · a license key.
The server validates your license online at every startup — there is no offline grace period.
Docker startup
At server startup, GoDD checks whether the Docker daemon responds. On Windows and macOS, if it does not, GoDD checks whether Docker Desktop is already running before requesting a launch; it does not start a second instance. If process state cannot be confirmed, it skips the launch. Linux uses systemd/service to start Docker. The MCP server continues if Docker is unavailable. On Windows, Docker status-check helpers and MCP-managed child processes use hidden-console mode.
Breaking Registry change (#2986): responses must declare a content generation. CLIENT_GENERATION_MISSING means the server migration is incomplete; ask the Registry operator to finish it. CLIENT_GENERATION_MALFORMED means the generation metadata is invalid; CLIENT_GENERATION_SPLIT means a response mixes generations. These errors stop delivery. GENERATION_DIGEST_ABSENT is a separate, nonfatal diagnostic for delivery from the last-known-good cache. Failed MCP prompt requests now return a protocol error, and are not counted as usage.
Optional compatibility reporting with anonymous aggregates
Explicit participation only: the public route, policy and operational-log disclosure are verified. Delivery is available only after the reporting-enabled native artifacts and their packaged four-target gate are verified and promoted. Older prepared binaries keep delivery disabled.
Reporting is off unless you set GODD_NATIVE_HANDSHAKE_REPORTING=railway-aggregate-v2 after reading the privacy policy. The version 2 reporting policy discloses Railway operational logging of IP, User-Agent, URL and request metadata; the transport is not anonymous. Old anonymous-v1 consent is not reused. On a startup compatibility rejection, GoDD sends only its reason code, the stable npm version, and the OS family to a fixed HTTPS endpoint, once, with at most 1.5 seconds waiting for the reporting subprocess, plus binary preparation and cleanup. No license, identity, path, digest, or command is sent. The server keeps daily counts for 30 UTC days; production collection requires verified dedicated ingress and disclosure. Counts are reports from volunteers, not user counts or a rejection rate. Unset the variable and restart GoDD to withdraw consent. Individual reports cannot be identified for deletion. Reporting failures never change startup behavior.
Everything else
The full tool list, CLI reference, and troubleshooting live on the documentation site.
The Stage 1 Rust archive admission reader is available for bounded OOXML
package diagnostics. godd-native office-package-admission --path <file>
returns a non-disclosing JSON receipt; strict is the default profile and
there is no disabled mode. Wiring this gate into the Office engine operation
and recursive expansion of embedded archives are later integration stages.
Every completed diagnostic admission attempt is appended to
<resolved GoDD root>/state/office/package-admission-receipts.ndjson; a
receipt-write failure makes the command fail closed. Use --receipt <path>
only when an additional nofollow audit destination is needed. A persistence
failure does not rewrite the admission verdict, but the CLI exits 2 and does
not forward an unaudited ALLOW receipt. Private staging is released before receipt
persistence, including failure paths. Input paths with parent traversal, symlinks,
reparse points, or hard links are rejected; reading uses the same opened file handle.
Relative OPC relationship targets may resolve .. within the package root;
root escapes remain denied. Empty ZIP directory markers are validated and
discarded outside the OPC part graph, while non-empty markers are denied.
Writing an adapter? All three subpath contracts (media interval / audio length / compile cache) ship with the package at docs/adapter-contracts.md.
License
Proprietary. A valid license key is required — see plans.
日本語
やりたいことを自然言語で言うだけ。GoDD が 設計 → 実装 → テスト → レビュー → ドキュメント → 出荷 まで一気通貫で回します。 Cursor / Claude Code / Codex / Kimi CLI / Antigravity の中で、MCP 経由で動きます。
GoDD の強み
- 1 回あたり約 2,000〜5,000 トークン。常時読み込み型なら約 80,000 以上。 プロンプトはオンデマンド配信で、呼び出したものだけがコンテキストに入ります。常時適用のルールファイルは、入力する前からコンテキストを食い潰します。
- AI が「当てずっぽう」をやめます。 すべてのプロンプトが 7 つの xDD(Spec / ATDD / Test / DDD / Neo-MDD / Docs / Issue Driven Development)を土台にしており、シニアエンジニアと同じ順序で設計・テスト・文書化します。
- 1 コマンドで一通り終わります。
/dev・/review・/shipはそれぞれが完結したサイクルで、逐一面倒を見る必要がありません。 - あなたのスタックを理解します。
godd-a initが言語・フレームワーク・ツールチェーンを判定し、配信されるプロンプトがそれに合わせて変わります。 - 乗り換え不要。 1 つのサーバーが、今使っているクライアント全てに登録されます。
インストール
npm install -g @autodevjapan/godd-mcp-alpha
godd-a install # インストール済みの MCP クライアントを自動検出して登録
godd-a init # プロジェクト設定を生成あとはクライアントで / を打って GoDD のプロンプトを選ぶだけ。「dev して」「レビューして」と話しかけても動きます。
動作要件
Node.js 22+ ・ MCP クライアント(Cursor / Claude Code / Codex / Kimi CLI / Antigravity)・ライセンスキー。
ライセンスは MCP サーバー起動のたびにオンラインで検証します。オフライン猶予期間はありません。
Docker の起動
MCP サーバー起動時に Docker daemon の応答を確認します。Windows/macOS では応答しない場合に Docker Desktop process を確認し、すでに起動していれば二重起動しません。プロセス状態を確認できない場合も追加起動を見送ります。Linux では systemd/service 経由で Docker の起動を試みます。Docker が使えなくても MCP サーバー自体は起動を続けます。Windowsでは、Docker状態確認用の補助プロセスとMCP管理下の子プロセスをコンソール窓なしで起動します。
Registry の破壊的変更(#2986): 応答の配信世代情報が必須になります。CLIENT_GENERATION_MISSING が出た場合は Registry 管理者にサーバー移行の完了を依頼してください。CLIENT_GENERATION_MALFORMED は世代情報の不正、CLIENT_GENERATION_SPLIT は応答内の世代混在を示し、いずれも配信を停止します。GENERATION_DIGEST_ABSENT は last-known-good キャッシュから配信した場合の非fatal診断です。失敗した MCP プロンプト要求はプロトコルエラーとなり、usage に計上しません。
起動時の互換検査を任意で報告し匿名集計する
利用者自身の明示同意で参加します。 公開経路と追加ポリシー、運用ログの告知を検証しました。送信可能なnative配布物と同じ候補パッケージの4環境検査を終えてmanifestを昇格した版で提供します。旧版の停止中バイナリは送信しません。
送信は初期状態で無効です。プライバシーポリシーを読み、GODD_NATIVE_HANDSHAKE_REPORTING=railway-aggregate-v2 を設定した利用者だけが参加します。互換検査が拒否した場合、理由コード・npmの正式製品版・OSの種類だけを固定HTTPS宛先へ1回送ります。報告用の子プロセスを待つ時間は最大1.5秒です。配布バイナリの再検証と後片付けの時間は別にかかります。ライセンス・識別子・パス・digest・コマンドは送信しません。サーバーは日別の件数を30 UTC日保存します。追加ポリシー第2版のとおり、RailwayはIP・User-Agent・URL等を運用ログに記録します。通信経路全体が匿名とは説明しません。旧anonymous-v1の同意は流用しません。件数は任意参加者の報告回数で、利用者数や拒否率ではありません。撤回は変数を削除してGoDDを再起動してください。識別子がないため個別報告の検索・削除はできません。報告失敗は起動結果に影響しません。
その他
ツール一覧・CLI リファレンス・トラブルシューティングは ドキュメントサイト にまとまっています。
Stage 1 の Rust archive admission reader で、ネイティブ OOXML package を
bounded に診断できます。godd-native office-package-admission --path <file>
は本文や entry 名を含まない JSON receipt を返し、既定 profile は strict
です(無効化モードはありません)。Office engine operation への配線と埋め込み
archive の再帰展開は後続 Stage の対象です。
診断 admission が完了した全 attempt は
<解決済み GoDD root>/state/office/package-admission-receipts.ndjson へ追記され、
receipt を保存できない場合は fail-closed で終了します。追加の監査先が必要な場合だけ
--receipt <path> を指定します。保存失敗は admission verdict を書き換えませんが、
監査されていない ALLOW receipt を渡さず CLI は exit 2 を返します。
private staging は receipt 保存前に解放され、保存失敗時も残しません。入力 path の
parent traversal・symlink/reparse point・hard link を拒否し、同一 file handle で読み取ります。
OPC relationship の相対 .. は package root 内に限って解決し、root escape は拒否します。
空の ZIP directory marker は検査後に OPC part graph の外で破棄し、非空 marker は拒否します。
アダプターを実装する場合、3 つの subpath 契約(media interval / audio length / compile cache)はパッケージ同梱の docs/adapter-contracts.md にあります。
ライセンス
商用ライセンス。利用にはライセンスキーが必要です — プランを見る。
Русский
Скажите, что нужно, обычными словами. GoDD проходит весь цикл — план → реализация → тесты → ревью → документация → поставка. Работает внутри Cursor, Claude Code, Codex, Kimi CLI и Antigravity по протоколу MCP.
Почему GoDD
- ~2 000–5 000 токенов на вызов вместо ~80 000+. Промпты доставляются по требованию — в контекст попадает только вызванный. Постоянно загруженные файлы правил съедают контекст ещё до первого сообщения.
- ИИ перестаёт угадывать. Каждый промпт построен на семи методологиях xDD (Spec / Acceptance-Test / Test / Domain / Neo-Model / Docs / Issue-Driven Development), поэтому он планирует, тестирует и документирует как старший инженер.
- Одна команда делает всю работу.
/dev,/review,/ship— каждая запускает полный цикл, а не отдельный шаг. - Он знает ваш стек.
godd-a initопределяет язык, фреймворк и инструменты, и промпты подстраиваются под них. - Ничего не нужно менять. Один сервер регистрируется во всех клиентах, которыми вы уже пользуетесь.
Установка
npm install -g @autodevjapan/godd-mcp-alpha
godd-a install # автообнаружение MCP-клиентов и регистрация в каждом
godd-a init # создать профиль проектаЗатем введите / в клиенте и выберите промпт GoDD — или просто попросите словами.
Требования
Node.js 22+ · MCP-клиент (Cursor / Claude Code / Codex / Kimi CLI / Antigravity) · лицензионный ключ.
Сервер проверяет лицензию онлайн при каждом запуске; офлайн-периода нет.
Запуск Docker
При запуске MCP-сервера GoDD проверяет, отвечает ли Docker daemon. На Windows/macOS, если daemon не отвечает, сначала проверяется, запущен ли Docker Desktop; повторный запуск не выполняется. Если состояние процесса нельзя определить, запуск тоже пропускается. На Linux используется systemd/service. MCP-сервер продолжает работу, даже если Docker недоступен. В Windows вспомогательные процессы проверки Docker и дочерние процессы MCP запускаются без отдельного окна консоли.
Несовместимое изменение Registry (#2986): ответ должен содержать данные о поколении контента. При CLIENT_GENERATION_MISSING попросите оператора Registry завершить миграцию. CLIENT_GENERATION_MALFORMED означает некорректные данные, CLIENT_GENERATION_SPLIT — смешанные поколения; доставка останавливается. GENERATION_DIGEST_ABSENT — отдельная нефатальная диагностика доставки из последнего проверенного кеша. Неудачные MCP-запросы промптов возвращают ошибку протокола и не учитываются как использование.
Добровольные отчёты о совместимости с анонимными агрегатами
Только добровольное участие: публичный маршрут, дополнительная политика и раскрытие служебных журналов проверены. Отправка доступна после проверки и продвижения нативных артефактов с включённой отправкой и одного пакета на четырёх платформах. Старые подготовленные бинарные файлы не отправляют данные.
Отправка выключена, пока вы не прочтёте политику конфиденциальности и не зададите GODD_NATIVE_HANDSHAKE_REPORTING=railway-aggregate-v2. При отказе проверки запуска GoDD один раз отправляет только код причины, стабильную версию npm и семейство ОС на фиксированный HTTPS-адрес. Ожидание процесса отправки — не более 1,5 секунды; подготовка и очистка проверенного бинарного файла требуют дополнительного времени. Лицензия, идентификаторы, пути, хеши и команды не передаются. Сервер хранит дневные счётчики 30 дней UTC. Дополнительная политика версии 2 раскрывает запись IP, User-Agent, URL и метаданных в служебные журналы Railway; транспорт не является анонимным. Старое согласие anonymous-v1 не используется. Это число добровольных отчётов, а не пользователей или доля отказов. Для отзыва согласия удалите переменную и перезапустите GoDD. Найти и удалить отдельный отчёт невозможно без идентификаторов. Ошибка отправки не меняет результат запуска.
Остальное
Полный список инструментов, справочник CLI и устранение неполадок — на сайте документации.
Пишете адаптер? Все три контракта subpath (media interval / audio length / compile cache) поставляются вместе с пакетом: docs/adapter-contracts.md.
Лицензия
Проприетарная. Требуется действующий лицензионный ключ — посмотреть тарифы.
