Skip to main content
Glama

FolioPilot

AI 에이전트가 MCP로 직접 관리하는 경력 포트폴리오 웹사이트 데스크톱 앱 A desktop app for your career portfolio site — edited by you and by AI agents over MCP.

Status: M0 (technical spike). 기획 전체는 docs/PLANNING.md 참고.

무엇이 되나요 (M0)

  • 앱 안에 MCP 서버 내장 (Streamable HTTP, 127.0.0.1, 토큰 인증)

  • stdio 브리지 — Claude Desktop, Cursor, Codex 등 stdio MCP 클라이언트 연결. 앱이 꺼져 있으면 트레이 모드로 자동 실행

  • 에이전트가 수정하면 편집 화면·활동 로그·미리보기가 즉시 갱신, 누가 바꿨는지 기록, Undo

  • preview_screenshot — 에이전트가 사이트 화면을 이미지로 받아 직접 확인

  • 삭제는 앱에서 사용자 승인 필요

MCP tools: get_portfolio, update_profile, upsert_project, delete_project, undo, list_history, preview_screenshot, get_preview_url

Related MCP server: PixelCheck

개발

요구사항: Node 22+, pnpm (corepack)

pnpm install
pnpm dev          # 앱 실행 (HMR)
pnpm test         # core / mcp 단위·통합 테스트
pnpm typecheck
pnpm build
pnpm e2e:stdio    # 빌드 후: stdio 브리지 → 앱 자동 실행 → tool 호출 → 스크린샷까지 검증

MCP 클라이언트 연결

앱 상단의 Copy stdio config 버튼이 현재 환경에 맞는 설정을 복사합니다. 형식:

{
  "mcpServers": {
    "foliopilot": {
      "command": "<FolioPilot 또는 electron 실행파일>",
      "args": ["<...>/out/main/bridge.js", "--app-path", "<...>/apps/desktop"],
      "env": { "ELECTRON_RUN_AS_NODE": "1" }
    }
  }
}

HTTP를 지원하는 클라이언트는 http://127.0.0.1:47821/mcp에 Authorization: Bearer <token> 헤더로 직접 연결할 수 있습니다 (토큰: 앱 데이터 폴더의 mcp-token).

구조

apps/desktop        Electron 앱 (main / preload / renderer / bridge)
packages/core       스키마(zod), Command 처리, 이력/Undo, 저장
packages/mcp        MCP tools, HTTP 호스트, stdio 브리지

License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers