Skip to main content
Glama
portfolio-mcp

portfolio-mcp

by NawafSheikh

portfolio-mcp

プロジェクトが入ったディレクトリを読み取り、そこに何があるかを教えてくれるMCPサーバー:各プロジェクトが何で作られているか、git管理されているか、どこにデプロイされているか、何が古くなっているか、そしてどれが最も収益に近いか。

読み取り専用です。スキャンしたものに対して書き込み、移動、削除は一切行いません。

インストール

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

Claude Codeに登録します:

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

または、mcpServersを読み取る任意のクライアントで:

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

Related MCP server: Charlie Work

設定

ハードコードされたものはありません。スキャンルートは次の順序で解決されます:

  1. コマンドラインの--root <path>(または--root=<path>)

  2. PORTFOLIO_ROOT環境変数

  3. プロセスの作業ディレクトリ

変数

デフォルト

目的

PORTFOLIO_ROOT

作業ディレクトリ

スキャンするプロジェクトを保持するディレクトリ

PORTFOLIO_VPS_HOST

未設定

セルフホスト型デプロイメントを示すホスト名またはアドレス。未設定の場合、vpsプラットフォームは一切報告されません

PORTFOLIO_OFFLINE

未設定

パッケージレジストリに到達する唯一のツールを拒否するには1に設定します

_archive、_backups、node_modules、.git、およびドットで始まるディレクトリはスキップされます。

ツール

インベントリ

ツール

機能

list_projects

すべてのプロジェクト。スタック、デプロイメントステータス、プラットフォーム、またはGitHubの有無でフィルタリング可能

get_project

1つのプロジェクトを詳細に:スタック、依存関係、git、デプロイメント、準備状況、行数

search_projects

名前、説明、フレームワーク、依存関係、またはカテゴリでマッチング

デプロイメント

ツール

機能

deployment_map

プラットフォームごとにグループ化されたすべて:Vercel、Netlify、Railway、Docker、セルフホスト、ローカルのみ

check_health

1つのプロジェクトが持つデプロイメント設定と、そのgit状態

git_overview

未コミットの作業、リモートの欠落、90日以上古いリポジトリ、gitがまったくないディレクトリ

収益

ツール

機能

revenue_scan

認証、決済、ランディングページ、デプロイメント、API、READMEについて、1つのプロジェクトを1〜10でスコアリング

find_opportunities

すべてのプロジェクトをランク付けし、クイックウィンを分離

suggest_actions

1つのプロジェクトに対する具体的な次のステップを優先順位順に

learn_patterns

集約ビュー:好まれるフレームワーク、繰り返し登場するスタック、強み

メンテナンス

ツール

機能

outdated_deps

1つのプロジェクトに対するnpm outdated、npm audit、pip list --outdated

stale_projects

最終コミットからの日数でソートされたプロジェクト

影響範囲

サーバーがあなたにとって重要なディレクトリを読み取るため、明確にしておきます:

  • 読み取りのみ。 どのツールもファイルの書き込み、移動、名前変更、削除を行いません。

  • パス封じ込め。 プロジェクト名は1つのディレクトリエントリです。区切り文字、..、絶対パス、ドライブ文字、ヌルバイト、Windowsデバイス名は拒否され、解決されたパスは設定されたルート内にあるかチェックされます。兄弟ディレクトリを読み取らせる方法はありません。

  • シェルなし。 すべてのサブプロセスは引数配列を持つexecFileSyncを通じて実行されます。ディレクトリ名がコマンド文字列に連結されることはありません。

  • サブプロセス。 リポジトリ状態のためのgit、およびoutdated_deps内でのみのnpm / pip。

  • ネットワーク。 outdated_depsだけがnpmおよびPyPIレジストリに到達します。なぜなら、それがnpm outdated、npm audit、pip list --outdatedの動作だからです。PORTFOLIO_OFFLINE=1を設定すると、代わりに拒否します。他のすべてのツールはローカルです。

  • 認証情報なし。 サーバーはトークンを読み取らず、どこにも何も送信しません。

スコアリング

revenue_scanとfind_opportunitiesは、検出が容易なシグナルから1〜10のスコアを生成します:デプロイメント設定、認証ライブラリ、決済ライブラリ、ランディングページのエントリポイント、README、gitリモート、APIフレームワーク、そしてカテゴリ乗数。これは大規模なディレクトリを整理するためのトリアージヒューリスティックであり、評価ではありません。ランキングを「まずこれらを見る」という意味として扱い、それ自体に意味のある数値としては扱わないでください。

開発

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

ライセンス

MIT。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