Code Reaper

CodeReaper

CodeReaper は、実際の UI を探索して V8 カバレッジを取得し、不要な JavaScript を検出して削除する、Cursor 向けの AI 駆動型 MCP ツールです。

主な機能

• Index ブラウザーエージェントによる自律的な UI 探索
• V8 の精密なカバレッジを使用して、実行回数がゼロの関数を特定
• リスクスコアの算出と削除の推奨
• パッチの生成と、任意での検証用リプレイ
• Cursor のワークフロー向け MCP 統合

クイックインストール

pip install codereaper
playwright install chromium
codereaper

codereaper を初めて実行すると、Gemini API キーを求められます。キーはグローバルの ~/.cursor/mcp.json に保存され、以降 Cursor から呼び出せるようになります。

別のインストール方法

# pipx
pipx run codereaper

前提条件

• Python 3.11+
• Playwright Chromium（playwright install chromium でインストール）
• Gemini API キー（または、プロバイダーを変更する場合は OpenAI／Anthropic）

クイックスタート

1. codereaper をインストールして実行します（~/.cursor/mcp.json が更新されます）
2. Cursor を再起動します
3. アシスタントに次のように依頼します。

   「http://localhost:3000 の不要な JavaScript コードを見つけてください」

使用方法

コマンド：

codereaper

ローカルのソースマッピングを使ったスキャンの例：

「http://localhost:3000 の不要なコードを見つけてください。ソースは ./test_site にあります」

MCP ツール

ツール	説明
find_dead_code	パイプライン全体を実行します：スキャン＋分析。ファイルパス、行番号、リスクスコア、削除の推奨を含む不要コードのレポートを返します。
scan_website	スキャンのみを実行します（分析なし）。後で使用する scan_id を返します。
analyze_dead_code	完了したスキャンを分析します。scan_id を指定します。
generate_patches	不要なコードを削除する統合 diff を生成します（conservative／balanced／aggressive）。
get_patch_diff	パッチの統合 diff を取得します。
apply_patch	ソースファイルにパッチを適用します（ロールバック用のスナップショットを保存します）。
verify_patch	パッチ適用後、ブラウザーエージェントを再実行してリグレッションを確認します。
rollback_patch	パッチ適用前のスナップショットから元のファイルを復元します。
list_scans	最近のスキャンを一覧表示します。
get_scan_status	スキャンの詳細なステータスを取得します。

トラブルシューティング

• ブラウザーが開かない場合は、Chromium をインストールしてください：playwright install chromium
• キー関連のエラーでスキャンに失敗する場合は、~/.cursor/mcp.json に GEMINI_API_KEY が設定されていることを確認してください
• ローカルページが読み込まれない場合は、開発サーバーが起動していて、アクセス可能であることを確認してください
• Gemini のレート制限に達した場合は、クォータがリセットされた後に再試行してください

更新情報

• 02-09-2026：v0.2.3 リリース

問題とフィードバック

再現手順と、可能であればログを添えて issue を作成してください。フィードバックや提案も歓迎します。