mcp-inventory

¿Qué herramientas MCP tienen realmente cargadas tus agentes?

Hoy ningún dev puede responderlo con certeza. Los servidores MCP viven repartidos en varios archivos de config (Claude Code, Claude Desktop, Cursor, VS Code) y lo único que ves es el nombre del servidor, nunca las tools que expone. mcp-inventory descubre esos configs, se conecta a cada servidor declarado, hace el handshake MCP y pide tools/list. El resultado es un inventario real, medido — no una suposición.

Uso

npx mcp-inventory

Sin instalación previa. Solo necesitás Node.js ≥ 18.

5 servidores · 41 herramientas

  Claude Code (global)
    context7             2 tools    stdio
    playwright           24 tools   stdio
    sequential-thinking  1 tool     stdio
    obsidian-vault       14 tools   stdio

  Claude Code (project: /Users/jose)
    github               — error: missing required Authorization header

Un servidor que falla (falta credencial, binario inexistente, se cuelga) aparece como error en su fila y no tumba el resto de la corrida.

Opciones

| Flag | Descripción | | ----------------- | ------------------------------------------------------------------ | | --json | Salida estructurada, con la lista completa de tools por servidor | | --timeout=<ms> | Timeout por servidor (default: 5000) | | -h, --help | Ayuda |

npx mcp-inventory --json

{
  "summary": { "servers": 5, "tools": 41, "ok": 4, "failed": 1 },
  "servers": [
    {
      "name": "context7",
      "client": "Claude Code (global)",
      "source": "/Users/jose/.claude.json",
      "transport": "stdio",
      "ok": true,
      "toolCount": 2,
      "tools": ["resolve-library-id", "query-docs"],
      "serverInfo": { "name": "context7", "version": "1.0.0" }
    }
    // ...
  ]
}

Qué mira

Busca configs de MCP en las ubicaciones estándar por SO de cada cliente, más los archivos de proyecto del directorio actual:

| Cliente | Ubicación | | -------------- | ------------------------------------------------------------- | | Claude Code | ~/.claude.json (global + servers por proyecto anidados) | | Claude Desktop | claude_desktop_config.json (macOS / Linux / Windows) | | Cursor | ~/.cursor/mcp.json, ./.cursor/mcp.json | | VS Code | mcp.json de usuario, ./.vscode/mcp.json (clave servers) | | Proyecto | ./.mcp.json |

Cubre los transportes stdio y Streamable HTTP. El transporte legacy HTTP+SSE (protocolo 2024-11-05) queda fuera de esta fase.

Garantías

• Solo lectura sobre los configs. Nunca escribe ni modifica nada.
• Nunca ejecuta herramientas (tools/call): solo initialize + tools/list.
• Nada cuelga la corrida: el timeout por servidor lo garantiza.
• Sin telemetría, sin estado en disco, sin red propia. Todo local.

Alcance

Esto es la Fase 0: únicamente el inventario. No incluye proxy, hashing / lockfile, detección de cambios, políticas ni dashboard — eso viene después.

Un límite deliberado de esta fase: los archivos de proyecto se buscan solo en el directorio actual, no en un crawl de todo el disco. Los servidores de Claude Code sí salen completos porque van embebidos en ~/.claude.json.

Desarrollo

git clone https://github.com/JoseFredes/mcp-inventory
cd mcp-inventory
npm install
npm run build
node dist/cli.js

Licencia

MIT