/ Directorio / Playground / claude-code-organizer
● Comunidad mcpware ⚡ Instantáneo

claude-code-organizer

por mcpware · mcpware/claude-code-organizer

Audita memories, MCPs y skills de Claude Code en un panel de control — además, un escáner que detecta intentos de envenenamiento de herramientas.

claude-code-organizer de mcpware es un panel de control local + escáner MCP. Muestra exactamente qué carga Claude Code en contexto (con conteos de tokens por elemento), marca servidores MCP con descripciones de herramientas sospechosas u ofuscadas, y ayuda a limpiar configuraciones duplicadas entre ámbitos de proyecto y globales.

Por qué usarlo

Características clave

Demo en vivo

Cómo se ve en la práctica

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

Instalar

Elige tu 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
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

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

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

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

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

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

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

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

Continue usa un array de objetos de servidor en lugar de un mapa.

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

Añádelo a context_servers. Zed recarga en caliente al guardar.

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

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: claude-code-organizer

Audita qué se precarga en cada sesión de Claude Code

👤 Usuarios avanzados cuyo contexto comienza medio lleno antes de escribir ⏱ ~15 min beginner

Cuándo usarlo: Las respuestas se sienten lentas o el contexto se llena rápidamente y sospechas de demasiadas memories/skills.

Requisitos previos
  • Claude Code instalado con memories/MCPs existentes — Configuración estándar de CC
Flujo
  1. Inicia el panel de control
    Ejecuta npx @mcpware/claude-code-organizer y abre el panel de control.✓ Copiado
    → El navegador abre con todos los ámbitos visibles
  2. Ordena por costo de token
    En el panel de control, ordena memories/skills por conteo de tokens — ¿cuáles son los 5 más grandes?✓ Copiado
    → Lista clara de principales culpables
  3. Poda sin piedad
    Elimina o mueve al ámbito del proyecto los que no son preocupaciones globales.✓ Copiado
    → El presupuesto de tokens baja

Resultado: Contexto precargado más pequeño, sesiones más rápidas, menor costo por llamada.

Errores comunes
  • Eliminar una memory en la que un compañero de equipo confía — Si es de todo el equipo, muévela al ámbito del proyecto en lugar de eliminarla

Escanea tus servidores MCP en busca de intentos de envenenamiento de herramientas

👤 Cualquiera que instale MCPs comunitarios ⏱ ~10 min intermediate

Cuándo usarlo: Antes o después de instalar un MCP de un editor desconocido.

Flujo
  1. Ejecuta el escáner
    Escanea todos los servidores MCP configurados en busca de patrones sospechosos en descripciones de herramientas.✓ Copiado
    → Informe con NEW/CHANGED/CLEAN por servidor
  2. Investiga los indicadores
    Para cada hallazgo marcado, muestra la descripción exacta de la herramienta y qué patrón se activó.✓ Copiado
    → Explicaciones vinculando patrón → evidencia
  3. Desactiva o elimina actores maliciosos
    Desactiva el MCP marcado del ámbito del proyecto y vuelve a escanear.✓ Copiado
    → Segunda ejecución limpia

Resultado: Los MCPs que intentan pasar instrucciones clandestinamente a través de descripciones de herramientas se detectan antes de comprometer una sesión.

Errores comunes
  • Falsos positivos en servidores legítimos que usan lenguaje inusual — Revisa la coincidencia de patrones; los falsos positivos no dañan, pero vuelve a habilitar después de verificar
  • El escáner solo detecta ataques de estilo prompt incrustado, no todo comportamiento malicioso — Aún así, revisa la fuente para MCPs que ejecutan código en tu máquina

Deduplica configuraciones MCP en ámbitos global y de proyecto

👤 Desarrolladores con configuraciones .mcp.json + ~/.claude en capas ⏱ ~5 min beginner

Cuándo usarlo: El mismo MCP registrado dos veces en diferentes ámbitos causando comportamiento extraño.

Flujo
  1. Detecta duplicados
    Encuentra servidores MCP registrados en múltiples ámbitos.✓ Copiado
    → Lista de duplicados con sus ámbitos
  2. Consolida
    Mantén la definición del ámbito del proyecto; elimina del global.✓ Copiado
    → Entrada canónica única

Resultado: Una configuración más limpia y con menos confusión.

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

claude-code-organizer + jetski

Organizer audita tu configuración local; Jetski audita el uso del lado del servidor

Después de que organizer redujo memories, verifica los análisis de Jetski para cualquier caída en fallos de llamadas de herramientas.✓ Copiado
claude-code-organizer + marm-systems

Mueve memory de larga duración de memories de CC a un MCP de memory apropiado

Encuentra memories en CC que son solo notas de proyecto factuales; propón moverlas a MARM-Systems a través de marm_contextual_log.✓ Copiado

Herramientas

Lo que expone este MCP

HerramientaEntradasCuándo llamarCoste
list_scopes (ninguno) Auditoría completa gratis
scan_mcps (ninguno) o servidor de destino Después de agregar cualquier MCP, o periódicamente gratis (se conecta brevemente a cada MCP)
token_report scope? Antes de podar gratis
dedupe (ninguno) Higiene de configuración gratis

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API
Ninguno
Tokens por llamada
Informes: 500-3000 tokens
Monetario
Gratis
Consejo
Ejecuta el escáner después de cada nueva instalación de MCP — es la defensa más económica.

Seguridad

Permisos, secretos, alcance

Almacenamiento de credenciales: Lee tus archivos de configuración de CC; no transmite
Salida de datos: Solo panel local; se conecta a servidores MCP solo para leer definiciones de herramientas

Resolución de problemas

Errores comunes y soluciones

Puerto del panel de control en uso

Mata la instancia anterior o establece un puerto diferente mediante env.

Verificar: lsof -i :<port>
El escáner no puede llegar a un MCP stdio

El escáner genera el mismo comando que tu cliente; asegúrate de que el comando funcione desde la terminal.

Verificar: Ejecuta el comando MCP manualmente
Falso positivo en un MCP en el que confías

Revisa la coincidencia, agrégala a una lista blanca en la configuración del organizador si es claramente benigna.

Verificar: Vuelve a ejecutar el escaneo con lista blanca

Alternativas

claude-code-organizer vs otros

AlternativaCuándo usarlaContrapartida
JetskiQuieres análisis y autenticación del lado del servidor, no limpieza de configuración localPreocupación diferente — runtime vs configuración
grep manual a través de ~/.claudeSi disfrutas del dolorSin escáner, sin interfaz de usuario

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills