/ ディレクトリ / プレイグラウンド / claude-code-organizer
● コミュニティ mcpware ⚡ 即起動

claude-code-organizer

作者 mcpware · mcpware/claude-code-organizer

Claude Codeのメモリ、MCP、スキルをダッシュボードで監査できます。さらに、ツールポイズニングの試みを検出するスキャナーも搭載しています。

mcpwareによるclaude-code-organizerは、ローカルダッシュボードとMCPスキャナーを提供します。Claude Codeがコンテキストに読み込むすべての項目(項目ごとのトークン数を含む)を表示し、不審または難読化されたツール説明を持つMCPサーバーにフラグを立て、プロジェクトスコープとグローバルスコープにまたがる重複設定のクリーンアップを支援します。

なぜ使うのか

主な機能

ライブデモ

実際の動作

claude-code-organizer.replay ▶ 準備完了
0/0

インストール

クライアントを選択

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "claude-code-organizer": {
      "command": "npx",
      "args": [
        "-y",
        "claude-code-organizer"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config を開く。保存後、アプリを再起動。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "claude-code-organizer": {
      "command": "npx",
      "args": [
        "-y",
        "claude-code-organizer"
      ],
      "_inferred": true
    }
  }
}

Cursor は Claude Desktop と同じ mcpServers スキーマを使用。プロジェクト設定はグローバルより優先。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "claude-code-organizer": {
      "command": "npx",
      "args": [
        "-y",
        "claude-code-organizer"
      ],
      "_inferred": true
    }
  }
}

Cline サイドバーの MCP Servers アイコンをクリックし、"Edit Configuration" を選択。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "claude-code-organizer": {
      "command": "npx",
      "args": [
        "-y",
        "claude-code-organizer"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop と同じ形式。Windsurf を再起動して反映。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "claude-code-organizer",
      "command": "npx",
      "args": [
        "-y",
        "claude-code-organizer"
      ]
    }
  ]
}

Continue はマップではなくサーバーオブジェクトの配列を使用。

~/.config/zed/settings.json
{
  "context_servers": {
    "claude-code-organizer": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "claude-code-organizer"
        ]
      }
    }
  }
}

context_servers に追加。保存時に Zed がホットリロード。

claude mcp add claude-code-organizer -- npx -y claude-code-organizer

ワンライナー。claude mcp list で確認、claude mcp remove で削除。

ユースケース

実用的な使い方: claude-code-organizer

Claude Codeセッションにプリロードされている内容を監査する

👤 入力する前からコンテキストが半分埋まっているパワーユーザー ⏱ ~15 min beginner

使うタイミング: レスポンスが遅い、またはコンテキストがすぐに埋まり、メモリやスキルが多すぎることが原因と疑われる場合。

前提条件
  • 既存のメモリ/MCPが設定されたClaude Codeがインストール済み — 標準的なCCセットアップ
フロー
  1. ダッシュボードを起動する
    npx @mcpware/claude-code-organizerを実行してダッシュボードを開きます。✓ コピーしました
    → ブラウザが開き、すべてのスコープが表示される
  2. トークンコスト順にソートする
    ダッシュボードでメモリ/スキルをトークン数でソートしてください。上位5件は何ですか?✓ コピーしました
    → 主要な負荷項目の一覧が明確に表示される
  3. 徹底的に整理する
    グローバルな関心事でないものは削除するか、プロジェクトスコープに移動してください。✓ コピーしました
    → トークンバジェットが減少する

結果: プリロードされるコンテキストが小さくなり、セッションが高速化し、呼び出しごとのコストが低減します。

注意点
  • チームメイトが依存しているメモリを削除してしまう — チーム全体で使うものであれば、削除ではなくプロジェクトスコープに移動する

MCPサーバーをスキャンしてツールポイズニングの試みを検出する

👤 コミュニティMCPをインストールするすべてのユーザー ⏱ ~10 min intermediate

使うタイミング: 信頼性が不明なパブリッシャーのMCPをインストールする前後。

フロー
  1. スキャナーを実行する
    設定済みのすべてのMCPサーバーをスキャンし、ツール説明に不審なパターンがないか確認します。✓ コピーしました
    → サーバーごとにNEW/CHANGED/CLEANのレポートが出力される
  2. フラグされた項目を調査する
    フラグされたすべての検出結果について、該当するツール説明と発火したパターンを表示してください。✓ コピーしました
    → パターンと証拠を紐づけた説明
  3. 問題のあるMCPを無効化または削除する
    フラグされたMCPをプロジェクトスコープから無効化し、再スキャンしてください。✓ コピーしました
    → 2回目のスキャンがクリーンになる

結果: ツール説明を通じて命令を紛れ込ませようとするMCPが、セッションを侵害する前に検出されます。

注意点
  • 特殊な言い回しを使う正当なサーバーでの誤検知 — パターンマッチの内容を確認する。誤検知は害にならないが、検証後に再度有効化すること
  • スキャナーはプロンプト埋め込み型の攻撃のみを検出し、すべての悪意ある動作を捕捉するわけではない — コードを実行するMCPについては、引き続きソースコードのレビューを行うこと

グローバルスコープとプロジェクトスコープ間のMCP設定の重複を解消する

👤 `.mcp.json`と`~/.claude`設定を重ねて使用している開発者 ⏱ ~5 min beginner

使うタイミング: 同じMCPが異なるスコープで二重に登録されていて、予期しない動作が発生している場合。

フロー
  1. 重複を検出する
    複数のスコープに登録されているMCPサーバーを検出してください。✓ コピーしました
    → 重複とそのスコープの一覧
  2. 統合する
    プロジェクトスコープの定義を残し、グローバルから削除してください。✓ コピーしました
    → 正規のエントリが1つになる

結果: よりクリーンで混乱の少ない設定になります。

組み合わせ

他のMCPと組み合わせて10倍の力を

claude-code-organizer + jetski

Organizerがローカル設定を監査し、Jetskiがサーバー側の使用状況を監査します

Organizerでメモリを整理した後、Jetskiのアナリティクスでツール呼び出し失敗の減少を確認してください。✓ コピーしました
claude-code-organizer + marm-systems

CCメモリから長期保存のメモリを適切なメモリMCPに移行する

CC内の事実ベースのプロジェクトメモを見つけて、marm_contextual_logを使ってMARMS-Systemsへの移行を提案してください。✓ コピーしました

ツール

このMCPが提供する機能

ツール入力呼び出すタイミングコスト
list_scopes (none) 完全な監査を行う場合 free
scan_mcps (none) or target server MCPを追加した後、または定期的に実行 free (connects to each MCP briefly)
token_report scope? 整理を行う前に実行 free
dedupe (none) 設定のメンテナンス時に実行 free

コストと制限

運用コスト

APIクォータ
なし
呼び出しあたりのトークン
レポート:500〜3000トークン
金額
無料
ヒント
新しいMCPをインストールするたびにスキャナーを実行してください。最もコストの低い防御策です。

セキュリティ

権限、シークレット、影響範囲

認証情報の保管: CCの設定ファイルを読み取りますが、外部には送信しません
データ送信先: ローカルダッシュボードのみ。MCPサーバーへの接続はツール定義の読み取り専用です

トラブルシューティング

よくあるエラーと対処法

Dashboard port in use

前回のインスタンスを終了するか、環境変数で別のポートを指定してください。

確認: lsof -i :<port>
Scanner can't reach a stdio MCP

スキャナーはクライアントと同じコマンドを起動します。ターミナルからそのコマンドが動作することを確認してください。

確認: Run the MCP command manually
False positive on an MCP you trust

マッチ内容を確認し、明らかに問題がなければOrganizerの設定でアローリストに追加してください。

確認: Re-run scan with allowlist

代替案

claude-code-organizer 他との比較

代替案代わりに使う場面トレードオフ
Jetskiローカル設定のクリーンアップではなく、サーバー側のアナリティクスと認証が必要な場合関心事が異なる — ランタイム vs セットアップ
Manual grep through ~/.claude苦行を楽しみたい場合スキャナーもUIもなし

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

🔍 400以上のMCPサーバーとSkillsを見る