portfolio-mcp

Un servidor MCP que lee un directorio lleno de proyectos y te dice qué hay en él: con qué está construido cada uno, si está en git, dónde está desplegado, qué se ha quedado obsoleto y cuáles están más cerca de generar dinero.

Es de solo lectura. Nunca escribe, mueve ni elimina nada de lo que escanea.

Instalación

npx portfolio-mcp --root /path/to/your/projects

Regístralo con Claude Code:

claude mcp add --scope user portfolio \
  -e PORTFOLIO_ROOT=/path/to/your/projects \
  -- npx -y portfolio-mcp

O en cualquier cliente que lea mcpServers:

{
  "mcpServers": {
    "portfolio": {
      "command": "npx",
      "args": ["-y", "portfolio-mcp"],
      "env": { "PORTFOLIO_ROOT": "/path/to/your/projects" }
    }
  }
}

Related MCP server: codescan-mcp

Configuración

Nada está fijo en el código. La raíz de escaneo se resuelve en este orden:

1. --root <path> (o --root=<path>) en la línea de comandos

2. la variable de entorno PORTFOLIO_ROOT

3. el directorio de trabajo del proceso

Se omiten _archive, _backups, node_modules, .git y los directorios que empiezan por punto.

Herramientas

Inventario

Despliegue

Ingresos

Mantenimiento

Qué toca

Siendo transparentes, porque el servidor lee un directorio que te importa:

• Solo lectura. Ninguna herramienta escribe, mueve, renombra ni elimina un archivo.

• Contención de rutas. El nombre de un proyecto es una entrada de directorio. Se rechazan separadores, .., rutas absolutas, letras de unidad, bytes nulos y nombres de dispositivo de Windows; además, se comprueba que la ruta resuelta esté dentro de la raíz configurada. No hay manera de conseguir que lea un directorio hermano.

• Sin shell. Todos los subprocesos funcionan con execFileSync y un array de argumentos. Los nombres de directorio nunca se concatenan como cadena de comandos.

• Subprocesos. git para el estado del repositorio, y npm / pip solo dentro de outdated_deps.

• Red. Únicamente outdated_deps alcanza los registros npm y PyPI, porque eso es lo que hacen npm outdated, npm audit y pip list --outdated. Si pones PORTFOLIO_OFFLINE=1, se rechaza; todo lo demás es local.

• Sin credenciales. El servidor no lee tokens y no envía nada a ningún sitio.

Puntuación

revenue_scan y find_opportunities producen una puntuación del 1 al 10 a partir de señales fáciles de detectar: configuración de despliegue, una librería de autenticación, una librería de pagos, una landing page, un README, un control remoto git, un framework de API y un multiplicador de categoría. Es una heurística de triaje para ordenar un directorio grande, no una valoración. Trata la clasificación como «mira estos primero», no como un número que signifique algo por lo mismo.

Desarrollo

npm ci
npm run build
npm test          # builds, then runs node --test
npm pack --dry-run

Licencia

MIT. Consulta LICENSE.