Code Assistant MCP server
2026년 11월 13일 커밋AI 클라이언트가 프로젝트 내 파일을 읽고, 검색하고, 편집하며 명령어를 실행하는 자율 코딩 에이전트를 실행할 수 있게 합니다.
다른 이름 stippi/code-assistant
- 스타
- 190
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- —
- 마지막 커밋
- 2026년 11월 13일
- 라이선스
- MIT
Code Assistant MCP란?
Code Assistant은(는) MCP server입니다. AI 클라이언트가 프로젝트 내 파일을 읽고, 검색하고, 편집하며 명령어를 실행하는 자율 코딩 에이전트를 실행할 수 있게 합니다.
프로젝트 README에서 생성된 요약
Code Assistant MCP server 정보
이 도구는 AI 클라이언트에서 직접 코드베이스를 관리하는 자율 코딩 에이전트를 실행할 수 있게 해줍니다. 모델이 로컬 프로젝트 내에서 파일을 읽고, 검색하고, 편집하며, 명령어를 실행할 수 있도록 하는 브리지 역할을 합니다. 개발자는 네이티브 GUI, 터미널 인터페이스 또는 Claude Desktop과 같은 클라이언트를 위한 헤드리스 MCP server를 통해 이를 사용할 수 있습니다. 또한 Zed와 같은 에디터를 위한 ACP agent 모드도 지원합니다.
시작하려면 Anthropic, OpenAI 또는 Google Vertex AI와 같은 LLM 제공업체를 선택하고 설정 화면을 통해 API key를 입력합니다. 이 시스템은 어떤 도구가 실행되고 어떤 컨텍스트를 반환하는지 정확히 보여주도록 투명하게 설계되었습니다. 파일 편집 내용을 자동 포맷터와 일치시키거나, PDF 또는 Excel 파일과 같은 비코드 문서를 Markdown으로 변환하여 읽는 등의 복잡한 작업을 처리합니다. 이를 통해 에이전트가 불필요한 재읽기로 토큰을 낭비하지 않고 프로젝트에 대한 정확한 이해를 유지할 수 있도록 합니다.
활용 사례
- 1자동화된 코드베이스 탐색에이전트에게 복잡한 레포지토리의 구조와 로직을 설명하도록 요청합니다.
- 2문서 통합 개발에이전트가 PDF나 Word 파일과 같은 프로젝트 문서를 참조하여 코딩 결정을 내리도록 지시합니다.
- 3웹 애플리케이션 테스트에이전트가 실제 브라우저를 제어하여 웹 애플리케이션을 탐색하고 상호작용하게 합니다.
- 4컨텍스트 인식 코드 편집프로젝트에서 자동 코드 포맷팅을 사용하는 경우에도 일관성을 유지하며 파일을 편집합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
구성
ANTHROPIC_API_KEY
| 이름 | 설명 | 유형 |
|---|---|---|
| ANTHROPIC_API_KEY | — |
자동 검사
2026년 11월 12일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능통과
- 오픈 소스 라이선스 (OSI)통과
- 최근 1년 내 커밋 또는 릴리스통과
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 원격 엔드포인트가 HTTPS 사용검사되지 않음
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 모델에 대한 숨겨진 지침 없음통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
README
GitHub에서 보기Code Assistant
An open-source AI coding agent, written in Rust, with a native GUI, a terminal mode, and integrations for editors and MCP clients. It runs an autonomous agent loop over your codebase — reading, searching, editing files, and running commands — while keeping you in the loop about what it is actually doing.
Getting started
The quickest way to try it is a prebuilt download — no toolchain required:
- Grab the latest build from the Releases page:
- macOS:
Code-Assistant-macos-aarch64.app.zip(Apple Silicon) orCode-Assistant-macos-x86_64.app.zip(Intel) - Linux:
code-assistant-linux-x86_64.zip - Windows:
code-assistant-windows-x86_64.zip
- macOS:
- Launch it. On first start, code-assistant opens its Settings screen. Pick a provider (there are one-click suggestions for the common ones), paste an API key, and choose a model — that's it.
- Add your project folder from within the app and start a chat.
No hand-editing of JSON files required to get going. (You still can, if you prefer — see the Configuration guide.)
# Install the Rust toolchain (macOS/Linux)
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
# On Linux (Debian/Ubuntu), install the system libraries gpui needs:
sudo apt-get install -y --no-install-recommends \
pkg-config build-essential libssl-dev libzstd-dev \
libfontconfig-dev libwayland-dev libx11-xcb-dev \
libxkbcommon-x11-dev libasound2-dev libvulkan1
# On macOS, install the metal toolchain:
xcodebuild -downloadComponent MetalToolchain
# Clone and build
git clone https://github.com/stippi/code-assistant
cd code-assistant
cargo build --release
The binary lands at target/release/code-assistant. See the
Configuration guide for building a self-contained
macOS .app bundle.
What makes it different
A handful of things we care about:
- A UI you can actually follow. Instead of a terse "Called 5 tools", code-assistant shows which tools ran and what each of them handed back to the model as context. When it goes off the rails, you can see why.
- Format-on-save that stays token-efficient. When your project auto-formats code, an agent's mental picture of a file goes stale and its follow-up edits start failing for non-obvious reasons. code-assistant runs your formatter and then reconciles the model's own edits with the formatted result — without wasting tokens on re-reading files. See docs/format-on-save-feature.md.
- Transparent file encoding & line endings. It reads a file however it is stored (encoding, BOM, CRLF/LF), gives the model clean text, and writes it back the way it was — so it never silently rewrites your line endings.
- Searches and reads documents, not just code. Word, Excel, PowerPoint, PDF and more are consumed automatically as Markdown, so you can point the agent at real-world documents alongside your source.
Features
- Multiple LLM providers: Anthropic, OpenAI, Google Vertex AI, Ollama, OpenRouter, SAP AI Core, Groq, Cerebras, Mistral, and more.
- Four ways to work: a native GUI (built on Zed's GPUI), a terminal mode, a headless MCP server, and an ACP agent for editors like Zed.
- Adaptive tool syntax: native function calling, XML tags, or triple-caret blocks — chosen per session to fit the model.
- Real-time streaming with smart filtering that blocks unsafe tool combinations (e.g. editing a file before reading it).
- Sessions per project with branching, persistent state, and draft messages with attachments.
- Sub-agents, permission tiers, a command sandbox, and automatic context compaction when the window fills up.
- MCP client mode: plug in external Model Context Protocol servers and use their tools.
- Browser sessions: the agent drives a real browser (navigate, read, click, type) to test web apps, with a human-in-the-loop login handoff so it acts as you without ever seeing your credentials.
- Skills: reusable, task-specific playbooks the agent can load on demand.
- Auto-loaded guidance: picks up
AGENTS.md(orCLAUDE.md) from your project root to align with repo-specific instructions.
Interfaces
code-assistant # native GUI (default)
code-assistant --tui # terminal interface
code-assistant acp # ACP agent for editors like Zed
code-assistant server # headless MCP server (e.g. Claude Desktop)
Any mode can take an initial task: code-assistant --task "Explain this codebase".
Add to your Zed settings:
{
"agent_servers": {
"Code-Assistant": {
"command": "/path/to/code-assistant",
"args": ["acp", "--model", "Claude Sonnet 4.5"],
"env": { "ANTHROPIC_API_KEY": "sk-ant-..." }
}
}
}
See Zed's docs on custom agents.
In Claude Desktop settings (Developer tab → Edit Config):
{
"mcpServers": {
"code-assistant": {
"command": "/path/to/code-assistant",
"args": ["server"],
"env": { "SHELL": "/bin/zsh" }
}
}
}
Configuration
For most people the in-app Settings screen is enough — it manages providers, models, MCP servers and skills for you. Everything can also be configured via JSON files, and there are more advanced options (project setup, sandbox modes, tool syntax, session recording, CLI flags):
→ See the Configuration guide.
Contributing
Contributions are welcome! The codebase is a decent tour of async Rust, AI agent architecture, and cross-platform UI. If something about the agent's behaviour annoys you, that is exactly the kind of detail this project cares about: please open an issue.
Roadmap
Not really a roadmap — just a few directions, in no particular order:
- Block replacing in stale files: detect early when the model is about to
replace_in_filea file that changed since it last read it, and reject with a helpful message. - Compact tool-use failures: strip failed tool calls / mismatched search blocks from the history to save tokens.
- Memory tools: help the agent build up a knowledge base for a project.
- Tighter sandboxing: restrict tool access to git-tracked files within the project.
- Fuzzy matching of search blocks: reduce the re-reads caused by failed exact matches.
Code Assistant MCP 질문
Code Assistant MCP server는 어떤 기능을 제공하나요?
헤드리스 MCP server를 실행하여 AI 클라이언트가 코드베이스를 읽고, 검색하고, 파일을 편집하며 명령어를 실행하는 자율 코딩 에이전트 루프를 가질 수 있도록 합니다.
Code Assistant를 Claude Desktop에 어떻게 연결하나요?
mcpServers 항목에 'server' 인자와 함께 code-assistant 바이너리를 가리키는 명령어를 추가하고, 필요한 경우 SHELL 환경 변수를 설정합니다.
Code Assistant는 어떤 LLM 제공업체를 지원하나요?
Anthropic, OpenAI, Google Vertex AI, Ollama, OpenRouter, SAP AI Core, Groq, Cerebras, Mistral 및 other를 지원합니다.
Code Assistant가 외부 MCP server를 사용할 수 있나요?
네, MCP client 모드를 지원하므로 외부 Model Context Protocol server를 연결하여 해당 도구들을 사용할 수 있습니다.
Code Assistant가 Zed와 같은 에디터에서도 작동하나요?
네, Zed의 agent_servers 설정에 등록하여 사용할 수 있는 ACP agent를 제공합니다.