/ Diretório / Playground / claude-code-organizer
● Comunidade mcpware ⚡ Instantâneo

claude-code-organizer

por 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.

Por que usar

Principais recursos

Demo ao vivo

Como fica na prática

claude-code-organizer.replay ▶ pronto
0/0

Instalar

Escolha seu cliente

~/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
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

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

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

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

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

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

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

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

O Continue usa um array de objetos de servidor em vez de um map.

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

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

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

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: 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

Quando usar: Responses feel slow or context fills fast and you suspect too many memories/skills.

Pré-requisitos
  • Claude Code installed with existing memories/MCPs — Standard CC setup
Fluxo
  1. Launch the dashboard
    Run npx @mcpware/claude-code-organizer and open the dashboard.✓ Copiado
    → 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?✓ Copiado
    → Clear top-offender list
  3. Prune ruthlessly
    Delete or move to project scope the ones that aren't global concerns.✓ Copiado
    → Token budget drops

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

Armadilhas
  • 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

Quando usar: Before or after installing an MCP from an unfamiliar publisher.

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

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

Armadilhas
  • 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

Quando usar: Same MCP registered twice in different scopes causing odd behavior.

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

Resultado: A cleaner, lower-confusion config.

Combinações

Combine com outros MCPs para 10× de alavancagem

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.✓ Copiado
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.✓ Copiado

Ferramentas

O que este MCP expõe

FerramentaEntradasQuando chamarCusto
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

Custo e limites

O que custa rodar

Cota de API
None
Tokens por chamada
Reports: 500-3000 tokens
Monetário
Free
Dica
Run the scanner after every new MCP install — it's the cheapest defense.

Segurança

Permissões, segredos, alcance

Armazenamento de credenciais: Reads your CC config files; doesn't transmit
Saída de dados: Local dashboard only; connects to MCP servers only to read tool definitions

Solução de problemas

Erros comuns e correções

Dashboard port in use

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

Verificar: 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.

Verificar: 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.

Verificar: Re-run scan with allowlist

Alternativas

claude-code-organizer vs. outros

AlternativaQuando usarTroca
JetskiYou want server-side analytics and auth, not local config cleanupDifferent concern — runtime vs setup
Manual grep through ~/.claudeYou enjoy painNo scanner, no UI

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills