# Local Dev MCP Agent

Windows용 Portable Coding Agent MCP의 Developer Baseline 구현이다. 프로젝트 내부에서는 파일 편집, process, package manager, 테스트와 Git workflow를 실용적으로 허용하고, filesystem tool과 process `cwd`는 `config.json`의 Allowed Project Boundary로 제한한다.

빠른 시작:

1. `config.json`의 `allowed_roots`를 설정한다.
2. `Verify-MCP.cmd`를 실행한다.
3. Codex는 STDIO MCP로 직접 등록한다.
4. ChatGPT는 `Start-ChatGPT-Tunnel.cmd`로 OpenAI Secure MCP Tunnel을 시작한 뒤 Tunnel connector를 사용한다.

상세 기준은 `MCP_DEV_BASELINE.md`, Phase 상태는 `ROADMAP.md`, 다른 PC 설치는 `MCP_PORTABLE_SETUP.md`를 참고한다.

Phase 2에서는 `project_registry`와 `project_list` / `project_open` / `project_context` / `project_close`를 제공한다. 등록 프로젝트는 반드시 기존 `allowed_roots` 내부여야 하며, active project는 상대 filesystem path와 process cwd의 기준만 바꾼다.

Phase 3에서는 `process_start` / `process_list` / `process_read` / `process_write` / `process_stop`으로 관리형 background process session을 제공한다. 장시간 dev server, watch, test runner처럼 즉시 반환이 필요한 프로세스를 띄우고 stdout/stderr를 읽거나 stdin을 보낼 수 있다. 기존 process allowlist, `shell=False`, Allowed Project Boundary, Git/package/network 정책을 그대로 재사용하며 범용 shell/PTTY를 새로 열지 않는다.

Phase 4에서는 `git_worktree_list` / `git_worktree_create` / `git_worktree_remove`로 관리형 Git linked worktree를 제공한다. worktree 경로는 기존 `allowed_roots` 내부여야 하고, 새 branch 생성만 지원하며 force 생성/삭제는 노출하지 않는다. dirty/untracked worktree는 Git의 기본 보호 동작에 따라 삭제되지 않고, 해당 worktree에서 managed process가 실행 중이면 제거를 거부한다. generic `run_process(git, ["worktree", ...])`는 계속 차단한다.

중요: 이 버전에는 Windows OS Process Sandbox가 없다.

ChatGPT Tunnel helper는 API key 평문을 프로젝트에 저장하지 않는다. 첫 입력값은 Windows Credential Manager에 보호 저장되며, 필요하면 `Start-ChatGPT-Tunnel.cmd reset-credential`로 삭제할 수 있다.