프로젝트 소개

opencode-mcp는 Claude Desktop, Claude Code, Cursor, VS Code, Windsurf 등과 같은 MCP 클라이언트를 OpenCode의 헤드리스 API에 연결하는 MCP(Model Context Protocol) 서버입니다. 이를 통해 코딩 작업 위임, 질문, 기능 구현, 백그라운드 작업 모니터링, 프롬프트 및 권한 응답, 프로젝트 전반의 변경 검토가 가능합니다. 주요 기능은 다음과 같습니다: - 포괄적인 상호작용을 위한 **70개의 도구, 10개의 리소스, 5개의 프롬프트**. - **워크플로 유연성**: 동기 실행(`opencode_run`), 백그라운드 실행(`opencode_fire`와 `opencode_check`/`opencode_wait`), 작업 관리(`opencode_job_list`, `opencode_job_get`, `opencode_job_cancel`) 중에서 선택할 수 있습니다. - **설정 및 안내**: `opencode_setup`, `opencode_context`, `opencode_provider_models`가 프로바이더와 모델 구성에 도움을 줍니다. - **다중 프로젝트 지원**: 프로젝트 범위 도구는 OpenCode 서버의 절대 경로를 받아들이며, POSIX, Windows 드라이브, UNC 경로를 지원합니다. - **구성**: `OPENCODE_BASE_URL`, `OPENCODE_AUTO_SERVE`, `OPENCODE_DEFAULT_PROVIDER`, `OPENCODE_DEFAULT_MODEL`과 같은 환경 변수로 사용자 정의할 수 있습니다. `OPENCODE_TOOL_PROFILE`을 통해 더 작은 `essential` 도구 프로필을 사용할 수 있습니다. - **개발 및 테스트**: 로컬 픽스처를 사용한 단위 테스트와 통제된 검증을 위한 라이브 스모크 테스트를 포함합니다. Node.js 22 이상이 필요합니다. 이 패키지는 npm에 배포되며 `npx opencode-mcp`를 통해 사용할 수 있습니다. 문서에서는 다양한 클라이언트 구성, 도구 참조, 리소스, 프롬프트, 예제, 아키텍처를 다룹니다.