CodeWeave

CodeWeave는 로컬 우선 MCP 서버로, AI 코딩 클라이언트에게 하나의 저장소 내에서 정밀한 검색, 보호된 편집, Git 작업, 의미론적 인텔리전스, 제한된 Bash 실행을 제공합니다.

저장소를 조용히 전환하거나, 부분 편집을 숨기거나, 전체 머신을 원격 서비스로 보내지 않으면서도 강력한 코딩 도구를 원하는 개발자를 위해 만들어졌습니다.

빠른 시작

Rust, Git, Bash가 필요합니다. Windows 사용자는 Git for Windows에 포함된 Bash를 사용할 수 있습니다.

cargo install --git https://github.com/abhij1306/codeweave --locked
codeweave install

대화형 설치 프로그램:

• CodeWeave가 제공할 저장소를 묻습니다.

• 로컬 stdio를 권장하거나 루프백 HTTP를 구성합니다.

• config.json과 비공개 오리진 토큰을 생성합니다.

• Git, Bash, 작업 공간, 구성, 토큰 권한, 포트, eager 인덱스 시작을 확인합니다.

• 붙여넣기 준비가 된 MCP 클라이언트 명령을 출력합니다.

자동화를 위해 마법사를 건너뛰려면:

codeweave init --path /absolute/path/to/repository --config config.json
codeweave doctor --config config.json

Related MCP server: MatterAI MCP Server

클라이언트 연결

로컬 클라이언트: stdio

Stdio는 가장 간단하고 안전한 전송 방식입니다. 설치 프로그램은 다음과 같은 블록을 출력합니다:

{
  "command": "/absolute/path/to/codeweave",
  "args": ["serve", "--transport", "stdio", "--config", "/absolute/path/to/config.json"]
}

로컬 명령을 허용하는 모든 MCP 클라이언트에 붙여넣으세요.

루프백 HTTP

codeweave serve --transport http --config config.json

로컬 엔드포인트는 기본적으로 http://127.0.0.1:8813/mcp입니다. HTTP는 .mcp-token에 저장된 bearer가 필요합니다. 이 토큰은 비공개 오리진 자격 증명이며, LLM API 키나 외부 사용자 인증이 아닙니다.

원격 클라이언트

단순히 bearer를 모든 공개 요청에 주입하여 루프백 오리진을 공개하지 마십시오. 공개 게이트웨이는 먼저 각 외부 호출자를 인증한 다음, CodeWeave로의 홉을 위해 비공개 오리진 bearer를 추가해야 합니다.

번들된 PowerShell 도우미는 ngrok에서 필수 HTTP Basic 인증을 사용한 후 오리진 bearer를 대체합니다:

.\start-ngrok.ps1 -Config .\config.json

PowerShell은 공개 사용자 이름과 비밀번호를 입력하라는 메시지를 표시합니다. 이 도우미는 Basic 자격 증명을 지원하는 클라이언트에서만 사용하십시오. URL 전용 호스팅 커넥터는 대신 OAuth를 지원하는 MCP 게이트웨이가 필요합니다. ChatGPT 설정 및 Claude 설정을 참조하세요.

CodeWeave가 제공하는 기능

CodeWeave는 하나의 고정된 25개 도구 표면을 제공합니다:

• 검색: workspace, code_retrieve, code_intelligence;

• 보호된 편집: code_write, code_replace, code_replace_range, code_insert, code_delete, code_rename, code_preview, code_transaction;

• Git: git_status, git_diff, git_log, git_show, git_blame, git_preflight, git_stage, git_commit, git_restore, git_push;

• 명령: bash, bash_status, bash_output, bash_cancel.

저장소는 프로세스 수명 동안 고정됩니다. 연결된 모든 클라이언트는 동일한 작업 공간 변경, 생성 및 Bash 실행을 공유합니다.

안전 모델

CodeWeave는 권한 있는 개발자 도구입니다. 인증된 클라이언트는 OS 계정으로 샌드박스되지 않은 Bash를 실행할 수 있으므로, 신뢰하는 클라이언트와 모델만 연결하십시오.

서버는 여전히 해당 신뢰 주변에 더 좁은 불변 조건을 적용합니다:

• 파일 읽기 및 쓰기는 구성된 작업 공간으로 기능이 제한됩니다.

• 스냅샷 해시, 범위 핸들, 예상 콘텐츠 검사가 편집을 보호합니다.

• 다중 파일 편집은 부분 적용 및 복구 실패를 정직하게 보고합니다.

• Git 경로 인수 및 파괴적 작업은 검증과 명시적 확인을 사용합니다.

• HTTP 인증은 제한된 4MiB 요청 본문 읽기 전에 발생합니다.

• 오리진은 HTTP/1만 허용하고 동시 연결 수를 제한합니다.

• bearer 파일은 Unix에서 0600을 사용하고 Windows에서 보호된 명시적 DACL을 사용합니다.

루프백을 넘어 HTTP를 노출하기 전에 SECURITY.md를 읽으십시오.

구성

codeweave install은 엄격한 configVersion: 2 구성을 생성합니다. 알 수 없는 필드는 거부되며, 알 수 없는 중첩 필드도 포함됩니다. 모든 옵션은 config.example.json을 참조하세요.

유용한 명령:

codeweave doctor --config config.json
codeweave serve --transport stdio --config config.json
codeweave serve --transport http --config config.json

선택적 의미론적 백엔드는 rust-analyzer, basedpyright-langserver, typescript-language-server입니다. 생성된 구성에서 활성화될 때까지 비활성화됩니다.

config.json, .mcp-token, .codeweave-cache/를 커밋하지 마십시오.

업데이트

GitHub에서 최신 릴리스를 설치하세요:

cargo install --git https://github.com/abhij1306/codeweave --locked --force
codeweave doctor --config /path/to/config.json

이전 Windows 릴리스는 상속된 권한으로 bearer 파일을 생성했습니다. doctor가 해당 파일을 거부하는 경우, CodeWeave를 중지하고 구성된 토큰 파일만 제거한 후 다시 시작하여 보호된 DACL로 토큰이 교체되도록 하십시오.

개발

git clone https://github.com/abhij1306/codeweave.git
cd codeweave
cargo fmt --check
cargo clippy --all-targets --all-features -- -D warnings
cargo test --all-targets

아키텍처 및 동시성 보장은 docs/architecture.md에 있습니다. 도구 계약은 docs/tools.md에 문서화되어 있으며, CONTRIBUTING.md를 통해 기여를 환영합니다.