OpenCode의 힘을 모든 MCP 클라이언트에 부여하세요.

opencode-mcp 는 AI 도구 (Claude, Cursor, Windsurf, VS Code 등) 를 OpenCode 의 headless API 로 연결하는 MCP 서버입니다. 이를 통해 AI 가 프로젝트 내에서 코드를 읽기, 쓰기, 실행하며 자율적으로 작업을 수행하는 OpenCode 세션에 실제 코딩 작업을 위임할 수 있습니다.

79 tools | 10 resources | 6 prompts | Multi-project | Auto-start

코딩 작업 위임— Claude 에 "REST API 를 만들어주세요"라고 지시하면 OpenCode 로 위임되며, 파일 생성, 패키지 설치, 테스트 작성 및 보고를 수행합니다.병렬 작업— 주요 AI 가 다른 작업을 수행하는 동안 여러 작업을 OpenCode 에 동시에 실행합니다.어떤 MCP 클라이언트든— Claude Desktop, Claude Code, Cursor, Windsurf, VS Code Copilot, Cline, Continue, Zed, Amazon Q 및 기타 모든 MCP 호환 도구와 호환됩니다.설정 없음— 서버는 opencode serve를 자동으로 시작합니다.

이미 실행 중이 아닌 경우에만 자동 시작됩니다. 수동 단계가 없습니다.

필수 조건: OpenCode 가 설치되어 있어야 합니다.curl -fsSL https://opencode.ai/install | bash

또는 npm i -g opencode-ai

또는 brew install sst/tap/opencode

Claude Code:

claude mcp add opencode -- npx -y opencode-mcp

Claude Desktop / Cursor / Windsurf / Cline / Continue (MCP 설정에 추가):

{
"mcpServers": {
"opencode": {
...

그만습니다. 클라이언트를 재시작하면 OpenCode 의 도구가 사용 가능합니다.

모든 클라이언트 설정 (VS Code Copilot, Zed, Amazon Q 등) 및 환경 변수에 대한 자세한 내용은 Configuration 을 참조하세요.

MCP Client <--stdio--> opencode-mcp <--HTTP--> OpenCode Server
(Claude, Cursor, etc.) (this package) (opencode serve)

MCP 클라이언트는 stdio 를 통해 도구를 호출합니다. 이 서버는 이를 OpenCode headless API 의 HTTP 요청으로 변환합니다. OpenCode 서버가 실행 중이 아니더라도 자동으로 시작됩니다.

79 개의 도구는 티어로 분류되어 있습니다. 워크플로우 도구부터 시작하세요. 하나의 호출로 일반적인 패턴을 처리합니다.

빠른 질문:

opencode_ask({ prompt: "Explain the auth flow in this project" })

무언가를 만들고 대기:

opencode_run({ prompt: "Add input validation to POST /api/users", maxDurationSeconds: 300 })

병렬 백그라운드 작업:

opencode_fire({ prompt: "Refactor the auth module to use JWT" })
→ sessionId 를 즉시 반환합니다
opencode_check({ sessionId: "..." })
...

Guided workflow templates your client can offer as selectable actions:

Every tool accepts an optional directory
parameter to target a different project. No restarts needed.

opencode_ask({ directory: "/home/user/mobile-app", prompt: "Add navigation" })
opencode_ask({ directory: "/home/user/web-app", prompt: "Add auth" })

All optional. Only needed if you've changed defaults on the OpenCode server.

| Variable | Default | Description |
|---|---|
OPENCODE_BASE_URL |
http://127.0.0.1:4096 |
OpenCode server URL |
OPENCODE_SERVER_USERNAME |
opencode |
HTTP basic auth username |
OPENCODE_SERVER_PASSWORD |
(none) |
HTTP basic auth password (enables auth when set) |
OPENCODE_AUTO_SERVE |
true |
Auto-start opencode serve if not running |
OPENCODE_DEFAULT_PROVIDER |
(none) |
Default provider ID when not specified per-tool (e.g. anthropic ) |
OPENCODE_DEFAULT_MODEL |
(none) |
Default model ID when not specified per-tool (e.g. claude-sonnet-4-5 ) |

git clone https://github.com/AlaeddineMessadi/opencode-mcp.git
cd opencode-mcp
npm install
...

End-to-end test against a running OpenCode server:

npm run build && node scripts/mcp-smoke-test.mjs

• Getting Started — step-by-step setup
• Configuration — env vars and all client configs
• Tools Reference — all 79 tools in detail
• Resources — 10 MCP resources
• Prompts — 6 guided workflow templates
• Examples — real workflow examples
• Architecture — system design and data flow