claude-delegate-local-mcp

Claude Code가 직접 호스팅하는 로컬 모델에 작업을 넘길 수 있게 해주는 MCP 서버입니다.

대량의 기계적이고 읽기 위주의 작업—서브시스템 읽기, 테스트 작성, 기계적 리팩터링, 1차 리뷰—은 필요한 추론이 적더라도 클라우드 토큰을 소모합니다. 이 서버는 그런 부류의 작업을 여러분의 하드웨어에서 처리하게 하여 사실상 무료로 만들고, Claude는 진짜 필요한 부분에만 사용하게 합니다.

상태: 초기 단계. 설정, 모델 레지스트리, 문서 도구는 갖춰져 있고 테스트를 거쳤습니다. 위임 도구 자체는 아직 만들어지지 않았습니다. 현재 실제 상황은 STATUS.md를, 진행 경로는 PLAN.md를 참고하세요.

작동 방식

두 가지 형태의 위임이 있으며, 두 번째가 핵심입니다:

• 단발(One-shot) — 파일 내용은 서버 측에서 읽혀 단일 프롬프트에 인라인됩니다. 모델이 답하고, 바이트가 Claude의 컨텍스트에 들어가지 않습니다. 리뷰, 요약, 설명에 적합합니다.

• 에이전트(Agentic) — 로컬 모델이 자체 read_file, write_file, run_bash를 갖고 반복합니다. 코드를 작성하고, 테스트 스위트를 실행하고, 실제 실패를 읽고, 고치고, 다시 실행합니다 — 필요한 만큼 많은 턴을 클라우드 토큰 비용 제로로 수행한 뒤, 결과를 Claude가 리뷰할 수 있도록 돌려줍니다.

두 번째 루프가 이 셸이 존재하는 이유이며, run_bash가 bubblewrap으로 비어 있는 루트의 샌드박스에 가둬지고 기본적으로 네트워크가 차단되는 이유입니다. bubblewrap을 사용할 수 없으면 서버는 제한 없는 쉘 명령을 실행하는 대신 실행을 거부합니다.

또한 서버는 실제 프로세스 종료 코드를 자체적으로 포착하여 모델이 답변에서 주장하는 내용과 별도로 보고합니다. 모델은 명령 결과를 잘못 보고하는 경우가 많고, 그렇다면 자기 검증이라는 아이디어 전체가 토대를 잃기 때문입니다.

Related MCP server: cctx

아닌 것들

• 클라우드 라우터가 아닙니다. 제공되는 백엔드 형식은 하나뿐입니다 — OpenAI 호환. Anthropic 호환 엔드포인트는 기존 이음매 뒤에 추가할 예비 항목이며, 현재 기능이 아닙니다.

• 다른 모델에 대해 Claude Code를 실행하는 방법이 아닙니다. 작업을 위임할 뿐이며, Claude Code는 그대로 Claude Code입니다.

• 신뢰할 수 없는 코드를 위한 샌드박스가 아닙니다. 여러분이 선택한 모델을, 여러분이 노출하기로 선택한 워크스페이스 대상으로 격리할 뿐입니다.

요구 사항

• 로컬 OpenAI 호환 엔드포인트 — (이 프로젝트는 vLLM이 DeepSeek V4 Flash를 두 대 DGX-Spark급 기계기계에서 서빙하는 상ann에서 구축했으니, 그 특정 스택에 종속된 것은 totally 없습니다).

• Python 3.11+

• Linux, 또는 Windows의 WSL2 — bubblewrap은 Linux 전용이고 Windows에 싸가한 대체가 없으므로, Claude Code가 않더라도 서버는 그곳에서 실행됩니다.

설치

git clone https://github.com/ComputerSaysNull/claude-delegate-local-mcp
cd claude-delegate-local-mcp

cp .env.example .env                  # then set DELEGATE_WORKSPACE_ROOTS
cp models.toml.example models.toml    # then set your endpoint

python -m venv .venv && .venv/bin/pip install -e ".[dev]"
python scripts/install_hooks.py       # optional, gives the gate at commit time

.env와 models.toml은 의도적으로 gitignore 됩니다. 그것은 호스트를 가리키며, 호스트네임은 주소만큼 확실하게 기기를 식별합니다.

Windows에서 서버를 WSL2로

wsl --install -d Ubuntu-24.04

그러고 Ubuntu 안에서 — 추측하지 말고 확인하세요, 두 가시는 중용으로 실패하니니까:

sudo apt install -y bubblewrap python3 python3-venv git
bwrap --unshare-all --ro-bind /usr /usr --ro-bind /etc /etc --proc /proc \
      --dev /dev --tmpfs /tmp --symlink usr/bin /bin --symlink usr/lib /lib \
      --symlink usr/lib64 /lib64 -- /bin/echo ok      # must print: ok
getent hosts YOUR-HEAD-NODE                           # must resolve in WSL, not just Windows

usr/lib64 심볼릭 링크는 x86-6에서 선택 사항이 아닙니다. 그것이 없으면 동적으로 연결된 아무것도 실행되지 않으며, 오류 메시지는 로더가 빠져 있다는 것이 아니라 실행 파일을 비난합니다.

Claude Code와 등록

네이티브 Linux:

{ "mcpServers": { "delegate-local": {
    "command": "claude-delegate-local-mcp",
    "timeout": 900000
} } }

Windows, 서버가 WSL2에:

{ "mcpServers": { "delegate-local": {
    "command": "wsl.exe",
    "args": ["-d", "Ubuntu-24.04", "-e", "claude-delegate-local-mcp"],
    "timeout": 900000
} } }

거소는 밀리초입니다. 벽-- def은 융으므로 넉은 위임 방식으 로 인데 로 인데 로 아