Skip to main content
Glama
portfolio-mcp

portfolio-mcp

by NawafSheikh

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: Charlie Work

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

Variable

Valor por defecto

Finalidad

PORTFOLIO_ROOT

directorio de trabajo

Directorio que contiene los proyectos a escanear

PORTFOLIO_VPS_HOST

sin definir

Nombre de host o dirección que marca un despliegue autoalojado. Mientras no esté definido, nunca se informa de una plataforma vps

PORTFOLIO_OFFLINE

sin definir

Defínela a 1 para rechazar la única herramienta que alcanza los registros de paquetes

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

Herramientas

Inventario

Tool

Qué hace

list_projects

Todos los proyectos, filtrables por stack, estado de despliegue, plataforma o presencia en GitHub

get_project

Un proyecto en profundidad: stack, dependencias, git, despliegue, preparación y recuento de líneas

search_projects

Coincidencias por nombre, descripción, framework, dependencia o categoría

Despliegue

Tool

Qué hace

deployment_map

Todo agrupado por plataforma: Vercel, Netlify, Railway, Docker, autoalojado, solo local

check_health

Qué configuración de despliegue lleva un proyecto y su estado de git

git_overview

Trabajo sin confirmar, remotemplates ausentes, repositorios obsoletos desde hace más de 90 días, directorios sin git

Ingresos

Tool

Qué hace

revenue_scan

Puntúa un proyecto del 1 al 10 en autenticación, pagos, landing page, despliegue, API y README

find_opportunities

Clasifica todos los proyectos y separa las victorias rápidas

suggest_actions

Próximos pasos concretos para un proyecto, en orden de prioridad

learn_patterns

Vista agregada: frameworks preferidos, stacks recurrentes y fortalezas

Mantenimiento

Tool

Qué hace

outdated_deps

npm outdated, npm audit y pip list --outdated para un proyecto

stale_projects

Proyectos ordenados por los días transcurridos desde el último commit

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.

Available Tools

12 tools
check_healthB

Check if a deployed project is reachable. Pings known URLs for Vercel/Netlify projects.

Inputs: name (required).

deployment_mapA

Full deployment overview: what's on Vercel, VPS, Netlify, Railway, Docker, or local-only. Grouped by platform.

Inputs: no named parameters.

find_opportunitiesA

Rank ALL projects by revenue potential. Returns top opportunities with scores, what's ready, what's missing, effort estimate, and suggested pricing.

Inputs: no named parameters.

get_projectB

Get deep info about one project: stack, deps, git, deployment, revenue readiness, LOC.

Inputs: name (required).

git_overviewA

Scan all projects for git state: uncommitted changes, no remote, stale repos (90+ days without commits).

Inputs: no named parameters.

learn_patternsA

Scan ALL projects to learn the developer's patterns: preferred frameworks, common stacks, architecture choices, strengths. Claude uses this to build better.

Inputs: no named parameters.

list_projectsB

List all projects with optional filters. Returns name, stack, deployment, github, last modified.

Inputs: stack, status, platform, hasGithub.

outdated_depsB

Check a project for outdated npm/pip dependencies and security vulnerabilities.

Inputs: name (required).

revenue_scanA

Analyze a project's monetization readiness. Checks auth, payments, landing page, deployment, API, README. Returns score 1-10 and suggested path.

Inputs: name (required).

search_projectsA

Search across project names, READMEs, package descriptions, and dependency names.

Inputs: query (required).

stale_projectsB

Find projects with no git commits in 90+ days, sorted by staleness.

Inputs: no named parameters.

suggest_actionsB

For a project, generate concrete monetization steps in priority order.

Inputs: name (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 12 tools

    Disambiguation2/5

    Several tools have overlapping boundaries. git_overview and stale_projects both identify projects with no commits in 90+ days, and deployment_map and list_projects both provide project lists with deployment information. This creates real ambiguity for an agent choosing between them.

    Naming Consistency4/5

    Most tools follow a clear verb_noun pattern like list_projects, get_project, search_projects, check_health, and find_opportunities. The exceptions are deployment_map and git_overview, which are noun phrases rather than verb-led names, but the naming remains largely predictable and readable.

    Tool Count4/5

    Twelve tools is within a reasonable range for a portfolio analysis server and each tool serves a distinct functional area overall. The count is slightly higher than necessary due to redundant stale-project logic and the partial overlap between deployment_map and list_projects, but it is not excessive.

    Completeness4/5

    The tool surface covers project discovery, deep inspection, deployment status, health checks, git hygiene, dependency vulnerabilities, revenue analysis, and opportunity ranking. Minor gaps exist, such as no bulk dependency scan across all projects and no direct action/deploy tools, but these are workable within the server's apparent analysis-focused purpose.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Scans codebases for TODOs, FIXMEs, code complexity, file stats, and dependencies, generating a health report with a letter grade. Zero configuration required.
      5 npm
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Scans repositories to produce a readiness score and actionable fixes across positioning, tryability, community, MCP, and monetization, plus generates launch assets and sponsor-tier ideas.
      5 npm
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      Scores local git repositories for README substance, license, package description, TypeScript config, tests, and GitHub Actions, providing a numbered hygiene report.
      2
      MIT