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 예약 장치 이름은 거부되며, 그 뒤 실제 도로 해석된 경로가 설정한 루트 안에 있는 내용을 확인한 경로를 사용합니다. 즉, 결코 다른 형제 디렉터리를 읽게 만들 수 없습니다.

• 셸 사용 안 함. 모든 하위 프로세스는 execFileSync 인자 배열 로 실행합니다. 디렉터리 이름을 문자열에 이어 붙여 단어 명령으로 쓰지 않습니다.

• 하위 프로세스. git은 저장소 상태를 위해, 되고 npm / pip는 outdated_deps에서만 실행됩니다.

• 네트워크. npm과 PyPI 레지스트리에 연결하는 것은 outdated_deps 뿐입니다. 왜냐하면 그것이 npm outdated, npm audit, pip list --outdated가 하는 일이기 때문입니다. PORTFOLIO_OFFLINE=1을 설정하면 그걸 이 거부합니다. 그 외 도구는 전부 로컬에서 원합니다.

• 자격 증명 없음. 서버는 어떤 토큰도 읽지 않으며, 어디에 무엇도 보내지 않습니다.

점 색상

revenue_scan과 find_opportunities는 감지 비용이 낮은 신호로 데이터 1~10 점수를 만듭니다. 곧 배포 설정, 인증 라이브러리, 결제 라이브러리, 랜딩 페이지 진입점, README, git 원격 지점, api API 프레임워크, 그다음 카테고리 배율( 카테고리 가중치)을 말합니다. 큰 디렉터리를 정렬 삼아 정리 분류를 위한 휴리스틱(어림판단)이지 가치 평가가 아닙니다. 따라서 이 순위를 그 자체로 절대적인 뜻이 있는 숫자로 생각하지 마시고 “이것부터 먼저 살펴보라”라는 신호로 보시면 됩니다.

개발

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

라이선스

MIT. LICENSE 참조.