/ 目录 / 演练场 / claude-code-organizer
● 社区 mcpware ⚡ 即开即用

claude-code-organizer

作者 mcpware · mcpware/claude-code-organizer

Audit Claude Code memories, MCPs, and skills in a dashboard — plus a scanner that catches tool-poisoning attempts.

claude-code-organizer by mcpware is a local dashboard + MCP scanner. It shows exactly what Claude Code loads into context (with per-item token counts), flags MCP servers with suspicious or obfuscated tool descriptions, and helps clean duplicate configs across project and global scopes.

为什么要用

核心特性

实时演示

实际使用效果

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

Audit what's preloaded into every Claude Code session

👤 Power users whose context starts half-full before they type ⏱ ~15 min beginner

何时使用: Responses feel slow or context fills fast and you suspect too many memories/skills.

前置条件
  • Claude Code installed with existing memories/MCPs — Standard CC setup
步骤
  1. Launch the dashboard
    Run npx @mcpware/claude-code-organizer and open the dashboard.✓ 已复制
    → Browser opens with all scopes visible
  2. Sort by token cost
    In the dashboard, sort memories/skills by token count — what are the top 5 biggest?✓ 已复制
    → Clear top-offender list
  3. Prune ruthlessly
    Delete or move to project scope the ones that aren't global concerns.✓ 已复制
    → Token budget drops

结果: Smaller preloaded context, faster sessions, lower per-call cost.

注意事项
  • Deleting a memory that a teammate relies on — If it's team-wide, move to project scope rather than delete

Scan your MCP servers for tool-poisoning attempts

👤 Anyone installing community MCPs ⏱ ~10 min intermediate

何时使用: Before or after installing an MCP from an unfamiliar publisher.

步骤
  1. Run the scanner
    Scan all configured MCP servers for suspicious patterns in tool descriptions.✓ 已复制
    → Report with NEW/CHANGED/CLEAN per server
  2. Investigate flags
    For every flagged finding, show the exact tool description and which pattern fired.✓ 已复制
    → Explanations linking pattern → evidence
  3. Disable or remove bad actors
    Disable the flagged MCP from project scope and re-scan.✓ 已复制
    → Clean second run

结果: MCPs that try to smuggle instructions via tool descriptions are caught before they compromise a session.

注意事项
  • False positives on legitimate servers using unusual language — Review the pattern match; false positives don't hurt, but re-enable after verifying
  • Scanner only catches embedded-prompt-style attacks, not all malicious behavior — Still review source for MCPs that execute code on your box

Deduplicate MCP configs across global and project scopes

👤 Developers with layered .mcp.json + ~/.claude configs ⏱ ~5 min beginner

何时使用: Same MCP registered twice in different scopes causing odd behavior.

步骤
  1. Detect duplicates
    Find MCP servers registered in multiple scopes.✓ 已复制
    → List of duplicates with their scopes
  2. Consolidate
    Keep the project-scope definition; remove from global.✓ 已复制
    → Single canonical entry

结果: A cleaner, lower-confusion config.

组合

与其他 MCP 搭配,撬动十倍杠杆

claude-code-organizer + jetski

Organizer audits your local config; Jetski audits server-side usage

After organizer trimmed memories, check Jetski's analytics for any drop in tool-call failures.✓ 已复制
claude-code-organizer + marm-systems

Move long-lived memory from CC memories into a proper memory MCP

Find memories in CC that are just factual project notes; propose moving them into MARM-Systems via marm_contextual_log.✓ 已复制

工具

此 MCP 暴露的能力

工具输入参数何时调用成本
list_scopes (none) Full audit free
scan_mcps (none) or target server After adding any MCP, or periodically free (connects to each MCP briefly)
token_report scope? Before pruning free
dedupe (none) Config hygiene free

成本与限制

运行它的成本

API 配额
None
每次调用 Token 数
Reports: 500-3000 tokens
费用
Free
提示
Run the scanner after every new MCP install — it's the cheapest defense.

安全

权限、密钥、影响范围

凭据存储: Reads your CC config files; doesn't transmit
数据出站: Local dashboard only; connects to MCP servers only to read tool definitions

故障排查

常见错误与修复

Dashboard port in use

Kill the previous instance or set a different port via env.

验证: lsof -i :<port>
Scanner can't reach a stdio MCP

The scanner spawns the same command your client does; make sure the command works from terminal.

验证: Run the MCP command manually
False positive on an MCP you trust

Review the match, add it to an allowlist in organizer settings if it's clearly benign.

验证: Re-run scan with allowlist

替代方案

claude-code-organizer 对比其他方案

替代方案何时用它替代权衡
JetskiYou want server-side analytics and auth, not local config cleanupDifferent concern — runtime vs setup
Manual grep through ~/.claudeYou enjoy painNo scanner, no UI

更多

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

🔍 浏览全部 400+ MCP 服务器和 Skills