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로 삭제할 수 있다.