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: codescan-mcp

設定

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

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

2. PORTFOLIO_ROOT環境変数

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

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

ツール

インベントリ

デプロイメント

収益

メンテナンス

影響範囲

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

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

• パス封じ込め。 プロジェクト名は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を参照してください。