Spec Driven Development
MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.
제작자가 쓴 설명(영어 원문)
Delegate coding tasks from Claude Code, Codex or opencode to any model opencode can run.
이 세 가지는 절대 하나의 점수로 합치지 않아요. 의견, 측정, 인기는 서로 다른 것이니까요.
이 서버는 아직 쉬운 말로 된 요약을 쓰지 못했어요. 아래는 레지스트리에서 읽어 온 사실이에요.
쓰고 있는 AI 앱을 고른 다음 설정을 복사하세요.
필요한 것
어떤 앱을 쓰세요?
위에서 앱을 고르세요. 기억해 두었다가 다음부터는 버튼에 “…에 설치”라고 표시해요.
Claude Desktop → Settings → Developer → Edit Config를 열고 claude_desktop_config.json에 이 내용을 붙여 넣으세요
{
"mcpServers": {
"forge-delegate": {
"command": "npx",
"args": [
"-y",
"forge-delegate",
"serve"
]
}
}
}터미널에서 이 명령어를 실행하세요
claude mcp add forge-delegate -- npx -y forge-delegate serve프로젝트의 .cursor/mcp.json 또는 ~/.cursor/mcp.json에 붙여 넣으세요
{
"mcpServers": {
"forge-delegate": {
"command": "npx",
"args": [
"-y",
"forge-delegate",
"serve"
]
}
}
}브라우저가 앱을 열지 물어본 다음, 앱이 설정을 보여 주고 확인을 요청해요. 키 값은 비워 두니 직접 입력하세요.
프로젝트의 .vscode/mcp.json에 붙여 넣으세요
{
"servers": {
"forge-delegate": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"forge-delegate",
"serve"
]
}
}
}브라우저가 앱을 열지 물어본 다음, 앱이 설정을 보여 주고 확인을 요청해요. 키 값은 비워 두니 직접 입력하세요.
이 서버는 내 컴퓨터에서 실행되는데, ChatGPT는 인터넷에 있는 서버에만 연결할 수 있어요. 다른 앱을 고르세요.
선택한 앱은 이 기기의 쿠키에만 저장돼요. 계정은 필요 없어요.
이 설정은 제작자의 레지스트리 정보로 만들었어요. README와 다르면 README를 따르세요.
내 컴퓨터에서 실행돼요. 설치하면 AI 앱에 도구 목록이 나타나요.
누구나 볼 수 있는 정보를 점검했고, 코드는 읽지 않았어요. 해당하지 않는 항목은 개수에서 뺐어요. · 2026년 11월 7일 점검
레지스트리 이름이 GitHub 계정 MuhamadBarzani 기준으로 확인되었고, 이 계정이 저장소를 소유하고 있어요
아직 GitHub에서 이 저장소를 읽어 오지 않았어요
아직 GitHub에서 이 저장소를 읽어 오지 않았어요
내 컴퓨터에서 실행되는 서버라 인터넷 엔드포인트가 없어요
내 컴퓨터에서 실행되며, 대신 로컬 설정을 사용해요
내 컴퓨터에서 실행돼요. 도구 목록은 인터넷 엔드포인트가 있는 서버에서만 읽을 수 있어요
레지스트리에서 이 카테고리의 활성 서버 전체와 비교했어요. 스타는 게시자가 저장소를 소유한 경우에만 세요.
해당하는 기본 점검 1개 중 1개를 통과했어요. 코드는 읽지 않았어요. 키나 토큰을 넣기 전에 서버가 어떤 권한을 요구하는지 확인하고, 꼭 필요한 권한만 있는 키를 쓰세요.
레지스트리에 필수 키가 나와 있지 않아요. 다만 처음 쓸 때 로그인을 요구하는 서버도 있어요.
내 컴퓨터에서 실행돼요. AI 앱이 필요할 때 실행하고, 데이터는 제작자의 서버를 거치지 않아요(서버 자체가 온라인 서비스를 호출하는 경우는 제외).
GitHub 저장소는 마지막으로 – 변경됐고, 최신 버전(1.2.4)은 10일 전 레지스트리에 올라왔어요.
Claude Desktop, Claude Code, Cursor, VS Code처럼 MCP를 지원하는 앱에서 쓸 수 있어요. 내 컴퓨터에 Node.js도 있어야 해요.
같은 카테고리에는: Spec Driven Development, Remote Desktop Commander, SuperCollider
같은 카테고리에서 다른 제작자가 만든 서버예요. 스타 순으로 정렬했어요.
카드 보는 법:★ GitHub 스타i세 기둥: 리뷰 · 점검 · 사용 정도i업데이트 = 최신 버전을 레지스트리에 공개한 날i
MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.
Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.
Make sound with SuperCollider: synths, drums, chords, melodies and soundscapes over OSC.
제작자의 저장소에서 쓰인 그대로 가져왔어요. PopNx MCP가 검토하거나 보증한 내용이 아니에요. HTML, 이미지, 스크립트는 제거했어요. 링크를 누르면 이 사이트를 벗어나요.
MCP server that delegates coding work from your primary agent (Claude Code, Codex, or opencode) to other AI models, so your main agent's context stays small. The high-volume typing happens in another model's context, usually a cheaper or free one, and only a summary comes back. Full agentic delegation via opencode for real work; direct API calls for second opinions.
Your main agent (the expensive one) keeps architecture, critical logic, and hard decisions. The cheap model grinds through the high-volume, low-risk work (boilerplate, repetitive edits, tests, lint/type fixes) and reports back.
┌──────────────────┐ MCP (stdio) ┌──────────────────┐ opencode run ┌──────────────────┐
│ Claude / Codex / │ ──────────────► │ forge-delegate │ ───────────────► │ opencode + cheap │ │ opencode (primary)│ │ (this server) │ --model cheap │ model │ └──────────────────┘ ◄────────────── └──────────────────┘ ◄─────────────── └──────────────────┘ result: text + session + token usage
Web configurator — pick model/targets/scope and get a ready-to-paste command (https://muhamadbarzani.github.io/forge-delegate/). The model picker is backed by the live models.dev catalog — searchable, with free/cheap filters and real prices, so you're picking from actual available models rather than guessing.
npx (recommended — works everywhere, no bash needed):
npx -y forge-delegate setup --model "opencode/deepseek-v4.1-flash-free" --targets "claude,codex,opencode"
That's it — npx bootstraps the package, and setup registers the MCP server with the agents you chose, sets your default model, and installs a small launcher that keeps the server up to date. Works on Windows (cmd/PowerShell), macOS, and Linux — no bash needed.
Run setup without flags and it walks you through the choices interactively (defaults in [brackets], Enter accepts). For the default model it lists every model your opencode can run and you pick one by number or name; pass any of the flags to skip that prompt. In an automated/non-terminal run it just uses sensible defaults.
GitHub Pages: enable it with *Settings → Pages → Deploy from a branch →
main//docs*.
The configurator lives at
docs/index.html.install.sh'sFORGE_DELEGATE_REPOdefault
(and the raw URL inside it) matters only if you self-host the fallback installer.
Working on a checkout yourself?
node cli.mjs setupdoes the same thing.
setup will:
--targets claude,codex,opencode).--model) so calls can omit model.startup_timeout_sec, tool_timeout_sec) above Codex's 10s/60s defaults so inline delegations aren't cut off.Routing and cost-policy guidance is injected by the MCP server itself into the agent's context via MCP instructions — no memory-file (CLAUDE.md/AGENTS.md) editing needed.
Then restart your agent and confirm the server is connected: /mcp in Claude Code, codex mcp, or opencode.
opencode run print help and exit successfully — so a pre-v2 binary fails silently. The server checks at startup and warns instead.opencode/* models** (e.g. opencode/deepseek-v4.1-flash-free) need no auth — zero setup.opencode auth login . forge-delegate reuses your opencode's credentials and never stores API keys. (Ollama needs no key, just the Ollama app running.)Use the npx route — no bash needed (works in cmd/PowerShell). All three targets, including native Windows Codex CLI, are supported.
--scope | Claude Code | Codex | opencode |
|---|---|---|---|
user (default) | ~/.claude.json — all projects | ~/.codex/config.toml — all projects | ~/.config/opencode/opencode.json — all projects |
project | .mcp.json in the project (needs one-time approval) | .codex/config.toml in the project (loads for trusted projects only) | opencode.json in the project |
opencode ships free no-auth models under opencode/:
npx -y forge-delegate setup --model "opencode/deepseek-v4.1-flash-free" --targets "claude,codex"
Other free options: opencode/mimo-v2.6-flash-free, opencode/nemotron-3.5-lightning-free. Free tiers are rate-limited; switch anytime with forge-delegate config set --model .
| Tool | What it does | Context cost |
|---|---|---|
ask_model | Second opinion from another model (direct API, no file access) | Small |
delegate | Model works autonomously via opencode's own tool loop — inline by default; background:true returns a job id to poll via check_delegation | Tiny→Medium |
check_delegation | Poll a background job (or list all with no id) | Tiny |
list_models | List local/keyless, direct-API, and agentic models | Small |
get_delegate_config | Read current configuration (default model, directory, autoApprove, profiles) | Tiny |
set_delegate_config | Change configuration at runtime — no reinstall | Tiny |
delegate is the context-saver: the external model gets its own tool loop executed by opencode locally. File contents never touch your main agent's context. Fast tasks return inline; long ones are auto-backgrounded by Claude Code (past ~2 min). Other hosts wait for an inline call, so the agent is told to pass background:true there for anything long.
Each delegation's result ends with the tokens it used and, when the provider reports prices, its cost. forge-delegate stats totals both per model.
| ✅ Delegate — high volume, low risk | ⛔ Keep on the primary agent |
|---|---|
| Tests for well-specified behavior | Architecture, system design, choosing abstractions |
| Boilerplate & scaffolding (CRUD, DTOs, fixtures, mocks) | Security-sensitive code (auth, crypto, secrets, permissions) |
| Mechanical edits across many files (renames, prop propagation, imports) | Concurrency, performance-critical paths, subtle correctness |
| Lint / formatting / type-error fixes | Ambiguous / underspecified requirements needing judgment |
| Docstrings, comments, README / changelog sections | Public API / interface design, breaking changes |
| Straightforward data transforms / migrations with a clear spec | Debugging unknown root causes |
| Obvious glue code / format conversions | Anything costly or hard to detect if wrong |
Full guide: docs/DELEGATION.md
delegate-work skillSetup also installs the skill for Claude Code (~/.claude/skills/delegate-work/, or /.claude/skills/ under --scope project) and for Codex (~/.agents/skills/delegate-work/, or /.agents/skills/). Skip it with --no-skill.
It exists because MCP server instructions are injected once at session start and get buried as the context fills — by turn 30 they lose to whatever is in front of the model. A skill description is re-matched against every user turn, so the delegation triggers ("write tests for", "rename X everywhere", "fix the lint errors") stay live for the whole session instead of decaying.
Stored in ~/.forge-delegate/config.json, read fresh on every call — change it anytime without reinstalling. Four ways:
get_delegate_config / set_delegate_config.forge-delegate config get, forge-delegate config set --model --timeout --dir --autoApprove false, forge-delegate config path.--model, --targets, --scope, --project-dir.| Field | Description | Default |
|---|---|---|
defaultModel | provider/model used when a call omits model | unset |
defaultAgent | opencode agent used for delegations | unset |
defaultVariant | default reasoning-effort variant | unset |
autoApprove | auto-approve permissions so headless delegations don't block | true |
timeoutMs | per-delegation timeout | 900000 (env FORGE_OPENCODE_TIMEOUT) |
defaultDirectory | default working directory for delegations | unset (server cwd) |
profiles | named presets { name: { model, agent, variant, autoApprove, directory } } | {} |
Every delegation tool also accepts per-call model, directory, agent, autoApprove, and profile overrides. Per-call values beat profile values beat config defaults.
opencode/deepseek-v4.1-flash-free, ...) plus anything you have logged in via opencode auth login .provider/model for OpenAI-compatible providers.opencode.json (@ai-sdk/openai-compatible + baseURL), callable as provider/model.ollama:llama3, local:qwen2.5-coder, no key needed.autoApprove: true runs delegations non-interactively with tool permissions granted — point them at repositories you trust and review the diffs. Set autoApprove: false to require manual approval.~/.forge-delegate/usage.jsonl; see forge-delegate stats.forge-delegate --version Print the installed version
forge-delegate setup Register with Claude Code / Codex / opencode forge-delegate serve Start the MCP server (used internally) forge-delegate config get | set | path forge-delegate status Show version, update mode, opencode logins, usage forge-delegate stats Show detailed usage statistics
setup on a published install writes ~/.forge-delegate/launcher.mjs and registers that path instead of npx. The launcher keeps a private install under ~/.forge-delegate/pkg, asks npm for the newest release at most every 6 hours, and installs newer same-major versions automatically. Installs use npm install --ignore-scripts, go through a staging directory, and fall back to the last good version if anything fails. A new version lands on the next agent start; the download itself happens in the background so startup is never delayed.
Disable automatic updates with FORGE_AUTO_UPDATE=0. A major release (2.0.0) is never installed automatically — re-run npx -y forge-delegate setup to take it deliberately.
The launcher is also the CLI entry point: node ~/.forge-delegate/launcher.mjs status reports the running version and update mode, and --version prints the version.
npx installs configured by hand are not covered by the launcher: npx keeps its cached copy forever, so clear it with rm -rf ~/.npm/_npx and restart. Running npx -y forge-delegate@latest setup migrates an npx install to the launcher; @latest gets its own npx cache slot, and if it still starts an old version, clear the cache first.
The primary install is npx -y forge-delegate setup, so the package must be on npm. Checklist:
npm run prepublishOnly — syntax-checks all entry files (runs automatically on publish).npm pack --dry-run — confirm the tarball contains only launcher.mjs, cli.mjs, server.mjs, lib.mjs, install.sh, docs/, skills/, README.md (via the files field), not node_modules.앞부분만 보여 드려요. 나머지는 저장소에서 읽어 보세요