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 以及点开头的目录都会被跳过。

工具

清单

部署

收入

维护

它涉及的内容

需要明确这一点，因为这个服务器会读取你关心的目录：

• 只读。 没有工具会写入、移动、重命名或删除文件。

• 路径隔离。 项目名是一个目录项。路径分隔符、..、绝对路径、盘符、空字节和 Windows 设备名都会被拒绝，解析后的路径随后会被检查是否位于配置的根目录内。没有任何办法让它读取相邻目录。

• 不调用 shell。 每个子进程都通过 execFileSync 并使用参数数组运行。目录名永远不会被拼接成命令字符串。

• 子进程。 git 用于获取仓库状态；npm / pip 只在 outdated_deps 中运行。

• 网络。 只有 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。