Skip to main content
Glama
portfolio-mcp

portfolio-mcp

by NawafSheikh

portfolio-mcp

Ein MCP-Server, der ein Verzeichnis voller Projekte liest und dir sagt, was darin ist: Womit jedes einzelne gebaut wurde, ob es in Git liegt, wo es bereitgestellt ist, was veraltet ist und welche am nächsten daran sind, Geld zu verdienen.

Er ist schreibgeschützt. Er schreibt, verschiebt oder löscht nie etwas, das er scannt.

Installation

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

Registriere ihn mit Claude Code:

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

Oder in einem beliebigen Client, der mcpServers liest:

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

Related MCP server: Charlie Work

Konfiguration

Nichts ist fest verdrahtet. Das Scan-Stammverzeichnis wird in dieser Reihenfolge aufgelöst:

  1. --root <pfad> (oder --root=<pfad>) in der Befehlszeile

  2. die Umgebungsvariable PORTFOLIO_ROOT

  3. das Arbeitsverzeichnis des Prozesses

Variable

Standard

Zweck

PORTFOLIO_ROOT

Arbeitsverzeichnis

Verzeichnis, das die zu scannenden Projekte enthält

PORTFOLIO_VPS_HOST

nicht gesetzt

Hostname oder Adresse, die ein selbst gehostetes Deployment kennzeichnet. Solange nicht gesetzt, wird niemals eine vps-Plattform gemeldet

PORTFOLIO_OFFLINE

nicht gesetzt

Auf 1 setzen, um das eine Werkzeug zu verweigern, das Paketregister erreicht

_archive, _backups, node_modules, .git und Verzeichnisse mit führendem Punkt werden übersprungen.

Werkzeuge

Inventar

Tool

Was es tut

list_projects

Jedes Projekt, filterbar nach Stack, Bereitstellungsstatus, Plattform oder GitHub-Präsenz

get_project

Ein Projekt im Detail: Stack, Abhängigkeiten, Git, Bereitstellung, Bereitschaft, Zeilenzahl

search_projects

Übereinstimmung bei Name, Beschreibung, Framework, Abhängigkeit oder Kategorie

Bereitstellung

Tool

Was es tut

deployment_map

Alles gruppiert nach Plattform: Vercel, Netlify, Railway, Docker, selbst gehostet, nur lokal

check_health

Welche Bereitstellungskonfiguration ein Projekt mit sich bringt, plus seinen Git-Status

git_overview

Nicht übertragene Änderungen, fehlende Remotes, Repos, die älter als 90 Tage sind, Verzeichnisse ohne Git

Einnahmen

Tool

Was es tut

revenue_scan

Bewertet ein Projekt von 1 bis 10 nach Authentifizierung, Zahlungen, Landingpage, Bereitstellung, API, README

find_opportunities

Reiht jedes Projekt ein und trennt die schnellen Erfolge ab

suggest_actions

Konkrete nächste Schritte für ein Projekt, in Prioritätsreihenfolge

learn_patterns

Aggregierte Sicht: bevorzugte Frameworks, wiederkehrende Stacks, Stärken

Wartung

Tool

Was es tut

outdated_deps

npm outdated, npm audit und pip list --outdated für ein Projekt

stale_projects

Projekte sortiert nach Tagen seit dem letzten Commit

Was es berührt

Um das klarzustellen, weil der Server ein Verzeichnis liert, das dir wichtig ist:

  • Nur lesen. Kein Werkzeug schreibt, verschiebt, benennt um oder löscht eine Datei.

  • Pfadeingrenzung. Ein Projektname ist ein Verzeichniseintrag. Trennzeichen, .., absolute Pfade, Laufwerksbuchstaben, Nullbytes und Windows-Gerätenamen werden abgelehnt, und der aufgelöste Pfad wird anschließend daraufhin überprüft, dass er sich innerhalb des konfigurierten Stammverzeichnisses befindet. Es gibt keine Möglichkeit, ein Nachbarverzeichnis lesen zu lassen.

  • Keine Shell. Jeder Unterprozess läuft über execFileSync mit einem Argumentarray. Verzeichnisnamen werden niemals in eine Befehlszeichenfolge eingefügt.

  • Unterprozesse. git für den Repository-Status und npm / pip nur innerhalb von outdated_deps.

  • Netzwerk. Nur outdated_deps erreicht die npm- und PyPI-Registrieren, denn das tun npm outdated, npm audit und pip list --outdated. Setze PORTFOLIO_OFFLINE=1 und es verweigert stattdessen. Jedes andere Werkzeug ist lokal.

  • Keine Anmeldeinformationen. Der Server liest keine Tokens und sendet nichts irgendwohin.

Bewertung

revenue_scan und find_opportunities erzeugen eine Bewertung von 1 bis 10 aus Signalen, die leicht zu erkennen sind: Bereitstellungskonfiguration, eine Authentifizierungsbibliothek, eine Zahlungsbibliothek, ein Einstiegspunkt für eine Landingpage, eine README, ein Git-Remote, ein API-Framework und dann ein Kategoriemultiplikator. Es ist eine Triage-Heuristik zum Sortieren eines großen Verzeichnisses, keine Bewertung. Behandle die Einstufung als „Schau dir diese zuerst an“, nicht als eine Zahl, die für sich genommen etwas bedeutet.

Entwicklung

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

Lizenz

MIT. Siehe 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