GoDD MCP α Server

🇺🇸 English | 🇯🇵 日本語 | 🇷🇺 Русский

English

AI prompt delivery system for Cursor IDE. Delivers project-optimized prompts, mindsets, and agent definitions via MCP (Model Context Protocol).

Installation

npm install -g @autodevjapan/godd-mcp-alpha

Setup (Recommended)

# Register the MCP server with Cursor IDE (auto-generates mcp.json)
godd-a install --license-key=YOUR_LICENSE_KEY

# Auto-generate project config.godd (interactive)
godd-a init

# Or fully automatic mode (for CI/CD)
godd-a init --auto

Use godd-a install. Manual editing of mcp.json is not recommended. godd-a install correctly configures the startup command, PATH, and license key.

Manual mcp.json Configuration

If godd-a install is unavailable, you can edit ~/.cursor/mcp.json directly. The serve argument is required. Without it, the installer mode starts and MCP communication breaks.

{
  "mcpServers": {
    "godd-a": {
      "command": "npx",
      "args": ["-y", "@autodevjapan/godd-mcp-alpha@latest", "serve"],
      "env": {
        "GODD_LICENSE_KEY": "GODD-XXXX-XXXX"
      }
    }
  }
}

Usage

After installation, restart Cursor IDE and the GoDD MCP α server will start automatically.

Option 1 — Slash command (recommended): Type / in the Cursor chat input to see GoDD prompts in the dropdown, then select one (e.g., /dev, /review).

Option 2 — Natural language in Agent mode: In Cursor's Agent mode, you can ask the AI in plain language (e.g., "run dev", "do a review") and the AI will automatically detect and call the appropriate GoDD tool.

Token Efficiency

GoDD MCP delivers prompts on demand — only the prompt you call is sent to the AI's context. This is fundamentally different from Cursor Rules, which loads all rules into every conversation from the start.

| Approach | How it works | Token cost per call | |---|---|---| | Plain Cursor (no GoDD) | No structured prompts; agent uses more iterations | ~80,000+ tokens per task | | GoDD MCP | Optimized prompts delivered on demand | ~2,000–5,000 tokens per call |

Use /metrics at any time during a session to see your actual token usage and estimated savings. Savings are measured empirically via benchmarks comparing GoDD-guided vs. unguided Cursor sessions.

GoDD Token Killer (godd-tk)

Bundled CLI proxy for 60-90% additional token savings on command output.

godd-tk intercepts shell commands executed by AI agents and compresses their output before it reaches the LLM. It is automatically installed alongside GoDD MCP via npm postinstall.

AI Agent → Shell("git status") → godd-tk → compressed output → AI Agent

| Feature | Description | |---|---| | Output filtering | Strips ANSI codes, noise lines, and verbose formatting | | Smart truncation | Keeps essential information, truncates repetitive output | | Usage analytics | Tracks tokens saved per command with built-in SQLite | | Auto-install | Downloaded automatically on npm install |

Run godd-tk gain to see cumulative token savings.

GoDD Prompts

Available GoDD prompts (MCP tools) in Cursor IDE:

| Prompt | Description | |---|---| | dev | Development (plan → implement → test → quality → docs in stages) | | check | Quality gate (verify spec alignment, tests, types, lint, security) | | docs | Generate/update documentation | | ship | Ship (commit at proper granularity → quality check → push → create PR) | | setup | Environment setup (with recommended stack presets, confirms missing info) | | review | Review (CTO-level review + quality gate) | | test | Run/create tests | | impact | Impact analysis | | commit | Commit changes | | push | Push to remote | | pr | Create PR (template-compliant) | | deploy | Deploy (with verification & rollback plan) | | adr | Create ADR (Architecture Decision Record) | | release | Generate release notes (SemVer-compliant) | | github | GitHub configuration (repository/branch protection etc.) | | config | Generate/repair config.godd (auto-detect stack + validation) | | questions | Manage question list (質問リスト.md) interactively | | e2e | Browser-based E2E testing (execute & verify critical user flows) | | map | Project knowledge graph (visualize architecture & dependencies with Mermaid) | | learn | Save/recall project-specific patterns, conventions, and pitfalls | | scratchpad | Persistent conversation memory — save/recall/search/list/forget with BM25 vector search | | diagram | Auto-update architecture diagrams (maintain living Mermaid docs in sync with code) | | slide | Generate presentation slides from project docs (Marp Markdown format) | | design | Generate/update visual designs from codebase (Pencil.dev sync) | | metrics | Token efficiency report — show prompt tokens delivered this session vs. unguided Cursor baseline (benchmark-based) |

CLI Commands

| Command | Description | |---|---| | godd-a install [--license-key=KEY] | Register MCP server with Cursor | | godd-a init [--force] [--lang=LANG] [--auto] | Generate project config.godd | | godd-a uninstall | Remove MCP server from Cursor | | godd-a serve | Start MCP stdio server (auto-invoked by Cursor) | | godd-a --version / godd-a -v | Show installed version |

Scratchpad (Persistent Memory)

GoDD includes a scratchpad system for storing and retrieving conversation memories across sessions.

Docker Desktop is auto-started when GoDD MCP launches (if installed). For manual setup:

# Start Qdrant for vector search (optional — works without it via local JSON fallback)
cd godd-mcp-alpha && docker compose up -d

| Action | Example | Description | |---|---|---| | save | scratchpad save Auth flow uses JWT + refresh tokens | Store a memory, returns a mem:: address | | recall | scratchpad recall mem::godd::abc123 | Retrieve full content by address | | search | scratchpad search authentication | BM25 search, returns top 5 matches | | list | scratchpad list | Show all saved memories | | forget | scratchpad forget mem::godd::abc123 | Delete a memory |

Without Docker/Qdrant, the scratchpad falls back to .godd/scratchpad.json with keyword-based search.

Getting a License Key

A license key is required to use GoDD MCP. Follow these steps:

1. Check plans at the GoDD official site
2. Register an account and purchase a subscription
3. Issue a license key from your dashboard

Set the issued license key with godd-a install --license-key=YOUR_KEY.

Requirements

• Node.js 22+
• Cursor IDE
• GoDD license key (get one at official site)

Troubleshooting

"0 tools available" is shown

If Cursor's MCP log shows errors like:

Unexpected end of JSON input
Unexpected token 'G', "GoDD MCP α"... is not valid JSON

Cause: mcp.json args does not include "serve". Without it, the installer mode starts (human-readable text output) and breaks the JSON-RPC communication Cursor expects.

Fix:

# Reinstall to regenerate mcp.json correctly
npx -y @autodevjapan/godd-mcp-alpha install --license-key=YOUR_KEY

Then restart Cursor.

License key is bound to another device

GoDD license keys are bound to a device. To use on a different device, issue a new license key.

godd-a install --license-key=NEW_LICENSE_KEY

License

Proprietary — A GoDD license key is required. Purchase at the official site.

日本語

Cursor IDE 向けの AI プロンプト配信システム。MCP (Model Context Protocol) を通じて、プロジェクトの技術スタックに最適化されたプロンプト・マインドセット・エージェント定義を提供します。

インストール

npm install -g @autodevjapan/godd-mcp-alpha

セットアップ（推奨）

# Cursor IDE に MCP サーバーを登録（mcp.json を自動生成）
godd-a install --license-key=YOUR_LICENSE_KEY

# プロジェクトの config.godd を自動生成（インタラクティブ）
godd-a init

# または完全自動モード（CI/CD 環境向け）
godd-a init --auto

godd-a install を使ってください。 mcp.json の手動編集は非推奨です。 godd-a install は起動コマンド・PATH・ライセンスキーを正しく設定します。

mcp.json を手動で設定する場合

godd-a install が使えない環境では、~/.cursor/mcp.json を直接編集できます。 serve 引数は必須です。 省略するとインストーラーモードで起動し、MCP 通信が破綻します。

{
  "mcpServers": {
    "godd-a": {
      "command": "npx",
      "args": ["-y", "@autodevjapan/godd-mcp-alpha@latest", "serve"],
      "env": {
        "GODD_LICENSE_KEY": "GODD-XXXX-XXXX"
      }
    }
  }
}

使い方

インストール後、Cursor IDE を再起動すると GoDD MCP α サーバーが自動で起動します。

方法 1 — スラッシュコマンド（推奨）: Cursor のチャット入力欄で / を入力するとドロップダウンに GoDD プロンプトが表示されます。選択して実行してください（例：/dev、/review）。

方法 2 — Agent モードでの自然言語指示: Cursor の Agent モードでは、自然言語で指示するだけで AI が適切な GoDD ツールを自動的に検出して呼び出します（例：「dev して」「レビューして」）。

トークン効率

GoDD MCP はプロンプトをオンデマンドで配信します。呼び出したプロンプトだけが AI のコンテキストに送られます。全ルールを毎会話の開始から常時コンテキストに含める Cursor Rules とは根本的に異なります。

| 方式 | 仕組み | 1回あたりのトークンコスト | |---|---|---| | 素の Cursor（GoDD なし） | 構造化プロンプトなし、エージェントの試行回数が増加 | ~80,000+ tokens / タスク | | GoDD MCP | 最適化されたプロンプトをオンデマンド配信 | ~2,000〜5,000 tokens / 呼び出し |

セッション中いつでも /metrics を実行すると、実際のトークン使用量と節約推定値を確認できます。節約効果は GoDD 使用時と未使用時の実測ベンチマークで計測されます。

GoDD Token Killer (godd-tk)

コマンド出力を圧縮し、さらに 60-90% のトークン削減を実現するバンドル CLI プロキシ。

godd-tk は AI エージェントが実行するシェルコマンドの出力をインターセプトし、LLM に渡す前に圧縮します。npm install 時に自動でインストールされます。

AI エージェント → Shell("git status") → godd-tk → 圧縮済み出力 → AI エージェント

| 機能 | 説明 | |---|---| | 出力フィルタリング | ANSI コード、ノイズ行、冗長な書式を除去 | | スマート切り詰め | 重要な情報を維持し、反復的な出力を切り詰め | | 使用量分析 | コマンドごとの節約トークン数を SQLite で追跡 | | 自動インストール | npm install 時に自動ダウンロード |

godd-tk gain で累計トークン節約量を確認できます。

GoDD プロンプト一覧

Cursor IDE 上で利用できる GoDD プロンプト（MCP ツール）の一覧です。

| プロンプト | 説明 | |---|---| | dev | 開発（段階的に計画→実装→テスト→品質→ドキュメントを実行） | | check | 品質ゲート（Spec整合・テスト・型・Lint・セキュリティを検証） | | docs | ドキュメント生成/更新 | | ship | 提出（適切な粒度でコミット → 品質チェック → プッシュ → PR 作成） | | setup | 環境構築（推奨スタックプリセット付き・不足情報は確認） | | review | レビュー（CTO レベルのレビュー + 品質ゲート） | | test | テスト実行/作成 | | impact | 影響分析 | | commit | 変更をコミット | | push | リモートにプッシュ | | pr | PR 作成（テンプレート準拠） | | deploy | デプロイ（検証・ロールバック計画付き） | | adr | ADR（Architecture Decision Record）作成 | | release | リリースノート生成（SemVer 準拠） | | github | GitHub 設定（リポジトリ/ブランチ保護等） | | config | config.godd を正確に生成・修正する（スタック自動検出 + バリデーション） | | questions | 質問リスト（質問リスト.md）からインタラクティブに質問を管理 | | e2e | ブラウザベース E2E テスト（重要ユーザーフローの実行・検証） | | map | プロジェクトナレッジグラフ（Mermaid でアーキテクチャ・依存関係を可視化） | | learn | プロジェクト固有のパターン・慣例・落とし穴を保存/参照 | | scratchpad | 会話記憶の永続化 — BM25 ベクター検索で save/recall/search/list/forget | | diagram | アーキテクチャ図の自動更新（コードと同期した Mermaid ドキュメントを維持） | | slide | プロジェクトドキュメントからプレゼンスライドを生成（Marp Markdown 形式） | | design | コードベースからビジュアルデザインを生成/更新（Pencil.dev 同期） | | metrics | トークン効率レポート — このセッションの配信トークン数と素の Cursor との比較（実測ベンチマークベース） |

CLI コマンド

| コマンド | 説明 | |---|---| | godd-a install [--license-key=KEY] | Cursor に MCP サーバーを登録 | | godd-a init [--force] [--lang=LANG] [--auto] | プロジェクトの config.godd を生成 | | godd-a uninstall | Cursor から MCP サーバーを削除 | | godd-a serve | MCP stdio サーバーを起動（Cursor が自動呼び出し） | | godd-a --version / godd-a -v | インストール済みバージョンを表示 |

スクラッチパッド（永続メモリ）

GoDD にはセッションをまたいで会話記憶を保存・検索できるスクラッチパッドシステムが組み込まれています。

GoDD MCP 起動時に Docker Desktop は自動的に起動されます（インストール済みの場合）。手動セットアップ:

# ベクター検索用に Qdrant を起動（任意 — なくてもローカル JSON フォールバックで動作）
cd godd-mcp-alpha && docker compose up -d

| アクション | 例 | 説明 | |---|---|---| | save | scratchpad save 認証フローは JWT + リフレッシュトークンを使用 | 記憶を保存し、mem:: アドレスを返す | | recall | scratchpad recall mem::godd::abc123 | アドレスで記憶の全文を取得 | | search | scratchpad search 認証 | BM25 検索、上位 5 件を返す | | list | scratchpad list | 保存された記憶の一覧を表示 | | forget | scratchpad forget mem::godd::abc123 | 記憶を削除 |

Docker/Qdrant なしの場合は .godd/scratchpad.json にフォールバックし、キーワードベースの検索で動作します。

ライセンスキーの取得

GoDD MCP を利用するにはライセンスキーが必要です。以下の手順で取得できます。

1. GoDD 公式サイト でプランを確認
2. アカウント登録 してサブスクリプションを購入
3. ダッシュボード からライセンスキーを発行

発行されたライセンスキーを godd-a install --license-key=YOUR_KEY で設定してください。

動作要件

• Node.js 22 以上
• Cursor IDE
• GoDD ライセンスキー（公式サイトで取得）

トラブルシューティング

「利用可能なツールが 0 個」と表示される

Cursor の MCP ログに以下のようなエラーが出ている場合:

Unexpected end of JSON input
Unexpected token 'G', "GoDD MCP α"... is not valid JSON

原因: mcp.json の args に "serve" が含まれていません。serve なしで起動するとインストーラーモード（人間向けテキスト出力）になり、Cursor が期待する JSON-RPC 通信に失敗します。

対処法:

# 再インストールで mcp.json を正しく再生成
npx -y @autodevjapan/godd-mcp-alpha install --license-key=YOUR_KEY

その後 Cursor を再起動してください。

ライセンスキーが別の端末に紐づいていると表示される

GoDD のライセンスキーは端末（デバイス）に紐づきます。別端末で使用する場合は新しいライセンスキーを発行してください。

godd-a install --license-key=NEW_LICENSE_KEY

ライセンス

Proprietary — GoDD ライセンスキーが必要です。公式サイトからご購入いただけます。

Русский

Система доставки AI-промптов для Cursor IDE. Предоставляет оптимизированные под технологический стек проекта промпты, мировоззрения и определения агентов через MCP (Model Context Protocol).

Установка

npm install -g @autodevjapan/godd-mcp-alpha

Настройка (рекомендуется)

# Зарегистрировать MCP-сервер в Cursor IDE (автоматическая генерация mcp.json)
godd-a install --license-key=YOUR_LICENSE_KEY

# Автоматическая генерация config.godd для проекта (интерактивный режим)
godd-a init

# Или полностью автоматический режим (для CI/CD)
godd-a init --auto

Используйте godd-a install. Ручное редактирование mcp.json не рекомендуется. godd-a install корректно настраивает команду запуска, PATH и лицензионный ключ.

Ручная настройка mcp.json

Если godd-a install недоступен, можно напрямую отредактировать ~/.cursor/mcp.json. Аргумент serve обязателен. Без него запускается режим установщика, и MCP-коммуникация нарушается.

{
  "mcpServers": {
    "godd-a": {
      "command": "npx",
      "args": ["-y", "@autodevjapan/godd-mcp-alpha@latest", "serve"],
      "env": {
        "GODD_LICENSE_KEY": "GODD-XXXX-XXXX"
      }
    }
  }
}

Использование

После установки перезапустите Cursor IDE — сервер GoDD MCP α запустится автоматически.

Способ 1 — Слэш-команда (рекомендуется): Введите / в поле чата Cursor — в выпадающем списке появятся промпты GoDD. Выберите нужный (например, /dev, /review).

Способ 2 — Естественный язык в режиме Agent: В режиме Agent Cursor можно просто попросить AI использовать нужный инструмент (например, «запусти dev», «сделай review») — AI автоматически обнаружит и вызовет соответствующий инструмент GoDD.

Эффективность токенов

GoDD MCP доставляет промпты по требованию — в контекст AI отправляется только вызванный промпт. Это принципиально отличается от Cursor Rules, где все правила загружаются в контекст с самого начала каждого чата.

| Подход | Принцип работы | Стоимость токенов за вызов | |---|---|---| | Cursor без GoDD | Нет структурированных промптов; агент тратит больше итераций | ~80 000+ токенов на задачу | | GoDD MCP | Оптимизированные промпты по требованию | ~2 000–5 000 токенов за вызов |

В любой момент сессии введите /metrics, чтобы увидеть фактическое использование токенов и расчётную экономию. Экономия измеряется эмпирически через бенчмарки, сравнивающие сессии с GoDD и без него.

GoDD Token Killer (godd-tk)

Встроенный CLI-прокси для дополнительной экономии 60-90% токенов на вывод команд.

godd-tk перехватывает команды оболочки, выполняемые AI-агентами, и сжимает их вывод перед отправкой в LLM. Автоматически устанавливается вместе с GoDD MCP через npm postinstall.

AI-агент → Shell("git status") → godd-tk → сжатый вывод → AI-агент

| Функция | Описание | |---|---| | Фильтрация вывода | Удаление ANSI-кодов, шумовых строк и избыточного форматирования | | Умная обрезка | Сохранение существенной информации, обрезка повторяющегося вывода | | Аналитика использования | Отслеживание сэкономленных токенов по командам через SQLite | | Автоустановка | Скачивается автоматически при npm install |

Запустите godd-tk gain для просмотра накопленной экономии токенов.

Список промптов GoDD

Доступные промпты GoDD (MCP-инструменты) в Cursor IDE:

| Промпт | Описание | |---|---| | dev | Разработка (поэтапно: план → реализация → тесты → качество → документация) | | check | Контроль качества (проверка соответствия спецификации, тесты, типы, линтер, безопасность) | | docs | Генерация/обновление документации | | ship | Отправка (коммит с правильной гранулярностью → проверка качества → push → создание PR) | | setup | Настройка среды (с рекомендуемыми пресетами стека, уточнение недостающей информации) | | review | Ревью (уровень CTO + контроль качества) | | test | Запуск/создание тестов | | impact | Анализ влияния | | commit | Коммит изменений | | push | Push на удалённый репозиторий | | pr | Создание PR (по шаблону) | | deploy | Деплой (с верификацией и планом отката) | | adr | Создание ADR (Architecture Decision Record) | | release | Генерация заметок к релизу (SemVer-совместимые) | | github | Настройка GitHub (защита репозитория/веток и т.д.) | | config | Генерация/исправление config.godd (автодетект стека + валидация) | | questions | Управление списком вопросов (質問リスト.md) в интерактивном режиме | | e2e | E2E-тестирование в браузере (выполнение и проверка критических пользовательских потоков) | | map | Граф знаний проекта (визуализация архитектуры и зависимостей через Mermaid) | | learn | Сохранение/вызов специфичных для проекта паттернов, соглашений и подводных камней | | scratchpad | Постоянная память диалога — save/recall/search/list/forget с BM25 векторным поиском | | diagram | Автообновление архитектурных диаграмм (поддержка актуальных Mermaid-документов) | | slide | Генерация презентационных слайдов из документации проекта (формат Marp Markdown) | | design | Генерация/обновление визуального дизайна из кодовой базы (синхронизация с Pencil.dev) | | metrics | Отчёт об эффективности токенов — токены этой сессии vs. базовый уровень Cursor без GoDD (на основе бенчмарков) |

Команды CLI

| Команда | Описание | |---|---| | godd-a install [--license-key=KEY] | Зарегистрировать MCP-сервер в Cursor | | godd-a init [--force] [--lang=LANG] [--auto] | Сгенерировать config.godd для проекта | | godd-a uninstall | Удалить MCP-сервер из Cursor | | godd-a serve | Запустить MCP stdio-сервер (автоматически вызывается Cursor) | | godd-a --version / godd-a -v | Показать установленную версию |

Скрэтчпад (постоянная память)

GoDD включает систему скрэтчпада для сохранения и поиска воспоминаний между сессиями.

Docker Desktop автоматически запускается при старте GoDD MCP (если установлен). Для ручной настройки:

# Запустить Qdrant для векторного поиска (опционально — работает и без него через локальный JSON)
cd godd-mcp-alpha && docker compose up -d

| Действие | Пример | Описание | |---|---|---| | save | scratchpad save Авторизация использует JWT + refresh-токены | Сохранить запись, возвращает адрес mem:: | | recall | scratchpad recall mem::godd::abc123 | Получить полное содержимое по адресу | | search | scratchpad search авторизация | BM25-поиск, возвращает топ-5 результатов | | list | scratchpad list | Показать все сохранённые записи | | forget | scratchpad forget mem::godd::abc123 | Удалить запись |

Без Docker/Qdrant скрэтчпад использует .godd/scratchpad.json с поиском по ключевым словам.

Получение лицензионного ключа

Для использования GoDD MCP необходим лицензионный ключ. Получите его следующим образом:

1. Ознакомьтесь с тарифными планами на официальном сайте GoDD
2. Зарегистрируйте аккаунт и приобретите подписку
3. Выпустите лицензионный ключ в личном кабинете

Установите полученный ключ командой godd-a install --license-key=YOUR_KEY.

Системные требования

• Node.js 22+
• Cursor IDE
• Лицензионный ключ GoDD (получите на официальном сайте)

Устранение неполадок

Отображается «0 доступных инструментов»

Если в логах MCP Cursor отображаются ошибки вида:

Unexpected end of JSON input
Unexpected token 'G', "GoDD MCP α"... is not valid JSON

Причина: В args файла mcp.json отсутствует "serve". Без него запускается режим установщика (текстовый вывод для человека), что нарушает JSON-RPC коммуникацию, ожидаемую Cursor.

Решение:

# Переустановите для правильной регенерации mcp.json
npx -y @autodevjapan/godd-mcp-alpha install --license-key=YOUR_KEY

Затем перезапустите Cursor.

Лицензионный ключ привязан к другому устройству

Лицензионные ключи GoDD привязываются к устройству. Для использования на другом устройстве выпустите новый ключ.

godd-a install --license-key=NEW_LICENSE_KEY

Лицензия

Проприетарная — требуется лицензионный ключ GoDD. Приобретите на официальном сайте.