feat(mcp): Phase 1 — parsec mcp serve + stdio JSON-RPC 2.0 server (Refs #293)

[erishforG]

무엇

parsec mcp serve 서브커맨드 + stdio JSON-RPC 2.0 서버 구현 (Phase 2, #293).

Phase 1 (#292) 에서 만든 TOOLS registry와 McpContext skeleton 위에 실제 transport loop를 구축.

왜

#293 의 핵심 deliverable: AI agent (Claude Desktop, Cursor) 가 parsec mcp serve 를 stdio MCP server로 등록하고 JSON-RPC 2.0 으로 호출할 수 있는 기반.

등록 예시 (claude_desktop_config.json):

{"command": "parsec", "args": ["mcp", "serve"]}

변경

파일	변경
src/mcp/server.rs	신규 — stdio JSON-RPC 2.0 루프 + 메서드 핸들러
src/mcp/mod.rs	pub mod server 노출 (+1 줄)
src/cli/mod.rs	parsec mcp serve 서브커맨드 추가

지원 메서드:

Method	상태	설명
initialize	✅ real	서버 메타데이터 + capabilities 반환
tools/list	✅ real	TOOLS registry 전체 반환 (10개)
tools/call	🔧 stub	Phase 3에서 실제 핸들러로 교체
shutdown	✅ real	null 결과 반환

다음 Phase 힌트

Phase 2 (#293): tools/call stub 을 실제 src/mcp/tools/ 핸들러와 연결. worktree_list 부터 시작 권장 (가장 읽기 전용 + 테스트 용이).

리스크

• low — 신규 파일 src/mcp/server.rs 만 추가. 기존 CLI 명령 변경 없음.
• src/cli/mod.rs 는 새 variant + match arm 추가만 (기존 시그니처 불변).
• spawn_blocking 으로 blocking stdin I/O 를 tokio async context 에서 안전하게 격리.

롤백

parsec mcp serve 서브커맨드 제거 + src/mcp/server.rs 삭제. 기존 명령에 영향 없음.

Test plan

cargo build --quiet        # ✅ pass
cargo fmt --check          # ✅ pass
cargo clippy -- -D warnings # ✅ pass
cargo test --quiet         # ✅ 90+81+7=178 tests pass (7 new in server::tests)

수동 smoke test:

echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}' | parsec mcp serve
echo '{"jsonrpc":"2.0","id":2,"method":"tools/list"}' | parsec mcp serve

Refs #293
Milestone: v1.0

@erishforG