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 <путь> (или --root=<путь>) в командной строке

  2. переменная окружения PORTFOLIO_ROOT

  3. рабочая директория процесса

Переменная

Значение по умолчанию

Назначение

PORTFOLIO_ROOT

рабочая директория

Каталог с проектами для сканирования

PORTFOLIO_VPS_HOST

не задано

Имя хоста или адрес, который помечает самостоятельное развёртывание. Пока не задано, платформа vps не сообщается никогда

PORTFOLIO_OFFLINE

не задано

Установите в 1, чтобы запретить единственный инструмент, который обращается к реестрам пакетов

_archive, _backups, node_modules, .git и каталоги с точкой в начале пропускаются.

Инструменты

Инвентаризация

Инструмент

Что делает

list_projects

Каждый проект, с фильтрами по стеку, статусу развёртывания, платформе или наличию GitHub

get_project

Один проект подробно: стек, зависимости, git, развёртывание, готовность, количество строк

search_projects

Поиск по имени, описанию, фреймворку, зависимости или категории

Развёртывание

Инструмент

Что делает

deployment_map

Всё, сгруппированное по платформе: Vercel, Netlify, Railway, Docker, самостоятельное, только локально

check_health

Какую конфигурацию развёртывания несёт один проект, плюс его состояние в git

git_overview

Незакоммиченная работа, отсутствующие удалённые репозитории, репозитории, устаревшие более 90 дней, каталоги вообще без git

Доход

Инструмент

Что делает

revenue_scan

Оценивает один проект от 1 до 10 по авторизации, платежам, лендингу, развёртыванию, API, README

find_opportunities

Ранжирует каждый проект и отделяет быстрые победы

suggest_actions

Конкретные следующие шаги для одного проекта в порядке приоритета

learn_patterns

Обобщённый взгляд: предпочитаемые фреймворки, повторяющиеся стеки, сильные стороны

Обслуживание

Инструмент

Что делает

outdated_deps

npm outdated, npm audit и pip list --outdated для одного проекта

stale_projects

Проекты, отсортированные по количеству дней с последнего коммита

Что он трогает

Будем честными, потому что сервер читает каталог, который вам дорог:

  • Только чтение. Ни один инструмент не пишет, не перемещает, не переименовывает и не удаляет файлы.

  • Ограничение пути. Имя проекта — это одна запись каталога. Разделители, .., абсолютные пути, буквы дисков, нулевые байты и имена устройств Windows отклоняются, а затем разрешённый путь проверяется на то, что он находится внутри настроенного корня. Невозможно заставить его читать соседний каталог.

  • Без оболочки. Каждый подпроцесс запускается через 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.

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