MCP server Code Assistant
Коммит 13 нояб. 2026 г.Позволяет AI-клиенту запускать автономного агента для написания кода, который может читать, искать, редактировать файлы и выполнять команды в вашем проекте.
Также известен как stippi/code-assistant
- Звёзды
- 190
- Инструменты
- —
- Загрузки, 30 дней
- —
- Последняя версия
- —
- Последний коммит
- 13 нояб. 2026 г.
- Лицензия
- MIT
Что такое Code Assistant MCP?
Code Assistant — это MCP server. Позволяет AI-клиенту запускать автономного агента для написания кода, который может читать, искать, редактировать файлы и выполнять команды в вашем проекте.
Сводка сгенерирована из README проекта
О Code Assistant MCP server
Этот инструмент позволяет запускать автономного агента для написания кода, который управляет вашей кодовой базой напрямую из AI-клиента. Он служит мостом, позволяющим моделям читать, искать, редактировать файлы и выполнять команды внутри вашего локального проекта. Разработчики могут использовать его через нативный GUI, терминальный интерфейс или как headless MCP server для таких клиентов, как Claude Desktop. Также поддерживается режим ACP agent для редакторов вроде Zed.
Для начала работы выберите провайдера LLM, например Anthropic, OpenAI или Google Vertex AI, и введите свой API key через экран настроек. Система спроектирована прозрачно: она показывает, какие именно инструменты запущены и какой контекст они возвращают. Инструмент справляется со сложными задачами, такими как согласование правок файлов с автоформаттерами, а также чтение нетекстовых документов (например, PDF или Excel) путем их преобразования в Markdown. Это гарантирует, что агент сохраняет точное представление о вашем проекте, не тратя токены на лишние повторные чтения.
Что вы можете с ним делать
- 1Автоматизированное исследование кодовой базыПопросите агента объяснить структуру и логику сложного репозитория.
- 2Разработка с интеграцией документацииДайте агенту указание использовать проектную документацию (например, PDF или Word) для принятия решений при написании кода.
- 3Тестирование веб-приложенийПозвольте агенту управлять реальным браузером для навигации и взаимодействия с вашим веб-приложением.
- 4Контекстное редактирование кодаВыполняйте правки файлов, которые остаются корректными даже если в вашем проекте используется автоматическое форматирование кода.
Взято из README проекта. Каждый вариант использования проверен на соответствие цитате из него.
Конфигурация
ANTHROPIC_API_KEY
| Название | Описание | Тип |
|---|---|---|
| ANTHROPIC_API_KEY | — |
Автоматические проверки
Запущено 12 нояб. 2026 г.Полный отчёт →Еще не проверено. Для сервера требуется оценка 80, отсутствие серьезных проблем и достаточно данных для нашей проверки. Как работают проверки · Что исправить, чтобы получить больше баллов
- Связанный и доступный исходный репозиторийПройдено
- Open source лицензия (OSI)Пройдено
- Коммит или релиз за последний годПройдено
- Имя пакета не похоже на популярный пакетНе проверялось
- Удаленная конечная точка использует HTTPSНе проверялось
- Деструктивные инструменты помеченыНе проверялось
- Нет скрытых инструкций для моделиПройдено
- Нет критических предупреждений в пакете или его зависимостяхНе проверялось
README
Открыть на GitHubCode 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?
Он запускает headless MCP server, который предоставляет AI-клиенту цикл автономного агента для работы с вашей кодовой базой: чтение, поиск, редактирование файлов и выполнение команд.
Как подключить Code Assistant к Claude Desktop?
Добавьте запись mcpServers, указывающую на бинарный файл code-assistant с аргументом 'server', при необходимости установив переменную окружения SHELL.
Какие провайдеры LLM поддерживает Code Assistant?
Поддерживаются Anthropic, OpenAI, Google Vertex AI, Ollama, OpenRouter, SAP AI Core, Groq, Cerebras, Mistral и другие.
Может ли Code Assistant использовать внешние MCP servers?
Да, у него есть режим MCP client, поэтому вы можете подключать внешние Model Context Protocol серверы и использовать их инструменты.
Работает ли Code Assistant в редакторах вроде Zed?
Да, он предоставляет ACP agent, который нужно зарегистрировать в настройках agent_servers в Zed.