portfolio-mcp
portfolio-mcp
プロジェクトが入ったディレクトリを読み取り、そこに何があるかを教えてくれるMCPサーバー:各プロジェクトが何で作られているか、git管理されているか、どこにデプロイされているか、何が古くなっているか、そしてどれが最も収益に近いか。
読み取り専用です。スキャンしたものに対して書き込み、移動、削除は一切行いません。
インストール
npx portfolio-mcp --root /path/to/your/projectsClaude 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
設定
ハードコードされたものはありません。スキャンルートは次の順序で解決されます:
コマンドラインの
--root <path>(または--root=<path>)PORTFOLIO_ROOT環境変数プロセスの作業ディレクトリ
変数 | デフォルト | 目的 |
| 作業ディレクトリ | スキャンするプロジェクトを保持するディレクトリ |
| 未設定 | セルフホスト型デプロイメントを示すホスト名またはアドレス。未設定の場合、 |
| 未設定 | パッケージレジストリに到達する唯一のツールを拒否するには |
_archive、_backups、node_modules、.git、およびドットで始まるディレクトリはスキップされます。
ツール
インベントリ
ツール | 機能 |
| すべてのプロジェクト。スタック、デプロイメントステータス、プラットフォーム、またはGitHubの有無でフィルタリング可能 |
| 1つのプロジェクトを詳細に:スタック、依存関係、git、デプロイメント、準備状況、行数 |
| 名前、説明、フレームワーク、依存関係、またはカテゴリでマッチング |
デプロイメント
ツール | 機能 |
| プラットフォームごとにグループ化されたすべて:Vercel、Netlify、Railway、Docker、セルフホスト、ローカルのみ |
| 1つのプロジェクトが持つデプロイメント設定と、そのgit状態 |
| 未コミットの作業、リモートの欠落、90日以上古いリポジトリ、gitがまったくないディレクトリ |
収益
ツール | 機能 |
| 認証、決済、ランディングページ、デプロイメント、API、READMEについて、1つのプロジェクトを1〜10でスコアリング |
| すべてのプロジェクトをランク付けし、クイックウィンを分離 |
| 1つのプロジェクトに対する具体的な次のステップを優先順位順に |
| 集約ビュー:好まれるフレームワーク、繰り返し登場するスタック、強み |
メンテナンス
ツール | 機能 |
| 1つのプロジェクトに対する |
| 最終コミットからの日数でソートされたプロジェクト |
影響範囲
サーバーがあなたにとって重要なディレクトリを読み取るため、明確にしておきます:
読み取りのみ。 どのツールもファイルの書き込み、移動、名前変更、削除を行いません。
パス封じ込め。 プロジェクト名は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 toolscheck_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
Scored across 12 tools
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.
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.
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.
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
Related MCP Connectors
Check in on projects' uptime: monitors, servers, sites, incidents, status pages and notices.
Evaluates any GitHub repository for license risk, maintenance velocity, stars/forks, and security.
Generate SBOMs, scan vulnerabilities, and analyze dependencies from local projects or Git repos.
Read a repository's to-do list, production issues and calls, and pull request reports on evalship.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceScans codebases for TODOs, FIXMEs, code complexity, file stats, and dependencies, generating a health report with a letter grade. Zero configuration required.5 npmMIT
- AlicenseAqualityCmaintenanceScans a repository for maintenance toil (flaky tests, expiring certificates, TODO rot, dead flags, etc.) and returns a prioritized queue with a credit ledger to track who cleared what.71MIT
- AlicenseNot gradedqualityDmaintenanceScans 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 npmMIT
- AlicenseBqualityCmaintenanceScores local git repositories for README substance, license, package description, TypeScript config, tests, and GitHub Actions, providing a numbered hygiene report.2MIT