/ 目錄 / 演練場 / claude-code-organizer
● 社群 mcpware ⚡ 即開即用

claude-code-organizer

作者 mcpware · mcpware/claude-code-organizer

透過儀表板審計 Claude Code 的記憶體、MCP 與技能,並附有可偵測工具投毒攻擊的掃描器。

mcpware 開發的 claude-code-organizer 是一個本地儀表板與 MCP 掃描工具。它能清楚顯示 Claude Code 載入到上下文的所有內容(含每個項目的 token 數量),標記具有可疑或混淆工具描述的 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

何時使用: 回應感覺變慢,或上下文很快就填滿,懷疑是記憶體或技能過多所致。

前置條件
  • 已安裝 Claude Code 並有現有的記憶體與 MCP — 標準 CC 設定
步驟
  1. 啟動儀表板
    執行 npx @mcpware/claude-code-organizer 並開啟儀表板。✓ 已複製
    → 瀏覽器開啟並顯示所有範圍
  2. 依 token 消耗排序
    在儀表板中,依 token 數量對記憶體/技能排序——排名前 5 的最大項目是哪些?✓ 已複製
    → 清楚的主要問題項目清單
  3. 大膽刪減
    刪除或將非全域性的項目移至專案範圍。✓ 已複製
    → Token 預算下降

結果: 預載的上下文更小,工作階段更快,每次呼叫的成本更低。

注意事項
  • 刪除了團隊成員依賴的記憶體 — 若是全團隊共用的,應移至專案範圍而非直接刪除

掃描你的 MCP 伺服器是否存在工具投毒攻擊

👤 任何安裝社群 MCP 的使用者 ⏱ ~10 min intermediate

何時使用: 在安裝來自不熟悉發佈者的 MCP 之前或之後。

步驟
  1. 執行掃描器
    掃描所有已設定的 MCP 伺服器,檢查工具描述中的可疑模式。✓ 已複製
    → 每個伺服器顯示 NEW/CHANGED/CLEAN 的報告
  2. 調查標記項目
    對於每個被標記的發現,顯示確切的工具描述及觸發的模式。✓ 已複製
    → 將模式與證據連結起來的說明
  3. 停用或移除惡意項目
    從專案範圍停用被標記的 MCP 並重新掃描。✓ 已複製
    → 第二次執行結果乾淨

結果: 試圖透過工具描述夾帶指令的 MCP,在危害工作階段前就被攔截。

注意事項
  • 在使用非常用語言的合法伺服器上產生誤報 — 檢閱模式比對結果;誤報不會造成傷害,但確認後可重新啟用
  • 掃描器僅能捕捉嵌入提示詞類型的攻擊,無法覆蓋所有惡意行為 — 對於在你的機器上執行程式的 MCP,仍需審查原始碼

刪除全域與專案範圍中的重複 MCP 設定

👤 同時使用 .mcp.json 與 ~/.claude 多層設定的開發者 ⏱ ~5 min beginner

何時使用: 同一個 MCP 在不同範圍重複註冊,導致奇怪的行為。

步驟
  1. 偵測重複項目
    找出在多個範圍中重複註冊的 MCP 伺服器。✓ 已複製
    → 重複項目及其所屬範圍的清單
  2. 整合設定
    保留專案範圍的定義;從全域範圍移除。✓ 已複製
    → 單一的正規條目

結果: 更乾淨、更不容易混淆的設定。

組合

與其他 MCP 搭配,撬動十倍槓桿

claude-code-organizer + jetski

Organizer 審計本地設定;Jetski 審計伺服器端用量

在 organizer 精簡記憶體後,查看 Jetski 的分析報告,確認工具呼叫失敗率是否有所下降。✓ 已複製
claude-code-organizer + marm-systems

將長期存放在 CC 記憶體中的內容移至專用記憶體 MCP

找出 CC 中只是專案事實備註的記憶體;提議透過 marm_contextual_log 將它們移入 MARM-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 配額
None
每次呼叫 Token 數
Reports: 500-3000 tokens
費用
Free
提示
每次安裝新 MCP 後執行掃描器——這是最低成本的防禦手段。

安全

權限、密鑰、影響範圍

憑證儲存: 讀取你的 CC 設定檔;不對外傳輸
資料出站: 僅限本地儀表板;僅連線至 MCP 伺服器以讀取工具定義

故障排查

常見錯誤與修復

Dashboard port in use

終止先前的執行實例,或透過環境變數設定不同的連接埠。

驗證: lsof -i :<port>
Scanner can't reach a stdio MCP

掃描器會以與用戶端相同的指令啟動 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你喜歡自討苦吃沒有掃描器,也沒有使用者介面

更多

資源

📖 閱讀 GitHub 上的官方 README

🐙 查看未解決的 issue

🔍 瀏覽全部 400+ MCP 伺服器和 Skills