프로젝트 소개

DevSpace는 ChatGPT와 Claude 같은 AI 어시스턴트를 로컬 개발 환경에 연결하는 자체 호스팅 MCP(Model Context Protocol) 서버입니다. 이를 통해 AI 클라이언트는 승인된 프로젝트 폴더에서 파일을 읽고, 쓰고, 편집하고, 검색할 수 있으며, 테스트와 빌드를 위한 셸 명령을 실행하고, 병렬 코딩 세션을 위해 격리된 Git 크트리를 사용할 수 있습니다. 이 모든 과정에서 코드를 제3자에게 업로드하지 않습니다. 이 프로젝트는 Node.js(>=22.19 <27 필요)로 구축되었으며 npm에 @waishnav/devspace로 게시되어 있습니다. 설치는 간단합니다. `npm install -g @waishnav/devspace`를 실행한 후 `devspace init`을 실행하면 대상(ChatGPT, 코딩 에이전트 또는 둘 다) 선택, 서브에이전트 선택, 허용된 프로젝트 루트 및 공용 HTTPS 터널 URL(Cloudflare Tunnel, ngrok, Pinggy, Tailscale Funnel 등) 구성 과정을 안내합니다. 연결되면 MCP 클라이언트는 저장소를 검사하고, 범위가 지정된 편집을 수행하고, 셸 명령을 실행하고, 로컬 에이전트 스킬을 발견하고, AGENTS.md 및 CLAUDE.md 파일의 프로젝트 지침을 따를 수 있는 도구를 게 됩니다. 서버는 단일 /mcp 엔드포인트를 노출하며, 이는 2026-07-28 요청별 프로토콜과 상태 비저장 호환성 처리를 통해 이전 2025년대 클라이언트를 모두 지원합니다. 보안은 클라이언트가 연결될 때 나타나는 Owner 비밀번호 승인 페이지를 통해 처리됩니다. 비밀번호는 init 중에 출력되며 ~/.devspace/auth.json에 저장됩니다. 사용자는 연결된 클라이언트를 자신의 머신에 접근할 수 있는 신뢰할 수 있는 코딩 파트너로 취급하도록 권장됩니다. 플랫폼 지원은 Linux, macOS, Windows를 포함하며 Bash 호환 (Git Bash, WSL, MSYS2 또는 Cygwin)이 필요합니다. `devspace doctor` 명령은 로컬 설정을 검사하는 데 도움이 됩니다. 이 프로젝트에는 설정, ChatGPT 코딩 워크플로, 구성, 보안 모델 및 문제 해결에 대한 문서가 포함되어 있습니다.