Позволяет AI-агентам классифицировать ошибки, исправлять баги, проверять достижимость результатов SARIF-сканеров и выполнять семантический поиск по коду внутри репозитория.
Также известен как thyn-ai/codna-cli, codna-cli, codna
- Звёзды
- 0
- Инструменты
- —
- Загрузки, 30 дней
- 13 218
- Последняя версия
- 0.2.113
- Последний коммит
- 14 нояб. 2026 г.
- Лицензия
- Apache-2.0
Что такое Codna MCP?
Codna — это MCP server. Позволяет AI-агентам классифицировать ошибки, исправлять баги, проверять достижимость результатов SARIF-сканеров и выполнять семантический поиск по коду внутри репозитория.
Сводка сгенерирована из README проекта
О Codna MCP server
Codna предоставляет AI-агентам интеллектуальный анализ репозиториев, сопоставляя кодовые базы для упрощения исправления багов и классификации ошибок. Она работает как MCP server через stdio, что позволяет интегрировать её с такими клиентами, как Cursor или Claude Desktop. Разработчики могут запускать её локально или в облаке, используя тот же движок, что и в CLI. Для работы инструментов требуется однократная бесплатная регистрация в сообществе через команду codna login, а для выполнения специфических задач, таких как исправление багов, необходим API ключ провайдера моделей, например Anthropic, OpenAI или Gemini.
Сервер предлагает пять основных инструментов: codna_triage для поиска релевантного кода, codna_secure для проверки достижимости результатов SARIF-сканеров (таких как CodeQL или Snyk) и codna_recall для семантического и лексического поиска по коду. Для активной разработки инструмент codna_fix может выявлять первопричины ошибок и даже открывать pull requests, если предоставлен токен GitHub. Уникальной особенностью является среда выполнения памяти на устройстве (on-device memory runtime), которая позволяет функции recall работать полностью офлайн без сетевых запросов после первоначальной настройки.
Взято из README проекта. Каждый вариант использования проверен на соответствие цитате из него.
Как установить Codna MCP
Форматы проверены 10 ноя 2026Добавить в CursorДобавить в GooseУстановка Codna MCP в Claude Code
$ claude mcp add --env 'ANTHROPIC_API_KEY=<YOUR_ANTHROPIC_API_KEY>' --env 'CODNA_API_KEY=<YOUR_CODNA_API_KEY>' --env 'GEMINI_API_KEY=<YOUR_GEMINI_API_KEY>' --env 'GITHUB_TOKEN=<YOUR_GITHUB_TOKEN>' --env 'OPENAI_API_KEY=<YOUR_OPENAI_API_KEY>' codna-cli -- uvx codnaУстановка Codna MCP в Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"codna-cli": {
"command": "uvx",
"args": [
"codna"
],
"env": {
"ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>",
"CODNA_API_KEY": "<YOUR_CODNA_API_KEY>",
"GEMINI_API_KEY": "<YOUR_GEMINI_API_KEY>",
"GITHUB_TOKEN": "<YOUR_GITHUB_TOKEN>",
"OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>"
}
}
}
}Установка Codna MCP в VS Code
.vscode/mcp.json
{
"servers": {
"codna-cli": {
"type": "stdio",
"command": "uvx",
"args": [
"codna"
],
"env": {
"ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>",
"CODNA_API_KEY": "<YOUR_CODNA_API_KEY>",
"GEMINI_API_KEY": "<YOUR_GEMINI_API_KEY>",
"GITHUB_TOKEN": "<YOUR_GITHUB_TOKEN>",
"OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>"
}
}
}
}Установка Codna MCP в VS Code CLI
$ code --add-mcp '{"name":"codna-cli","type":"stdio","command":"uvx","args":["codna"],"env":{"ANTHROPIC_API_KEY":"<YOUR_ANTHROPIC_API_KEY>","CODNA_API_KEY":"<YOUR_CODNA_API_KEY>","GEMINI_API_KEY":"<YOUR_GEMINI_API_KEY>","GITHUB_TOKEN":"<YOUR_GITHUB_TOKEN>","OPENAI_API_KEY":"<YOUR_OPENAI_API_KEY>"}}'Установка Codna MCP в Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"codna-cli": {
"command": "uvx",
"args": [
"codna"
],
"env": {
"ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>",
"CODNA_API_KEY": "<YOUR_CODNA_API_KEY>",
"GEMINI_API_KEY": "<YOUR_GEMINI_API_KEY>",
"GITHUB_TOKEN": "<YOUR_GITHUB_TOKEN>",
"OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>"
}
}
}
}Установка Codna MCP в Codex
$ codex mcp add codna-cli --env 'ANTHROPIC_API_KEY=<YOUR_ANTHROPIC_API_KEY>' --env 'CODNA_API_KEY=<YOUR_CODNA_API_KEY>' --env 'GEMINI_API_KEY=<YOUR_GEMINI_API_KEY>' --env 'GITHUB_TOKEN=<YOUR_GITHUB_TOKEN>' --env 'OPENAI_API_KEY=<YOUR_OPENAI_API_KEY>' -- uvx codnaУстановка Codna MCP в Codex config.toml
~/.codex/config.toml
[mcp_servers.codna-cli] command = "uvx" args = ["codna"] [mcp_servers.codna-cli.env] ANTHROPIC_API_KEY = "<YOUR_ANTHROPIC_API_KEY>" CODNA_API_KEY = "<YOUR_CODNA_API_KEY>" GEMINI_API_KEY = "<YOUR_GEMINI_API_KEY>" GITHUB_TOKEN = "<YOUR_GITHUB_TOKEN>" OPENAI_API_KEY = "<YOUR_OPENAI_API_KEY>"
Установка Codna MCP в Gemini CLI
$ gemini mcp add -s user -e 'ANTHROPIC_API_KEY=<YOUR_ANTHROPIC_API_KEY>' -e 'CODNA_API_KEY=<YOUR_CODNA_API_KEY>' -e 'GEMINI_API_KEY=<YOUR_GEMINI_API_KEY>' -e 'GITHUB_TOKEN=<YOUR_GITHUB_TOKEN>' -e 'OPENAI_API_KEY=<YOUR_OPENAI_API_KEY>' codna-cli uvx -- codnaУстановка Codna MCP в Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"codna-cli": {
"command": "uvx",
"args": [
"codna"
],
"env": {
"ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>",
"CODNA_API_KEY": "<YOUR_CODNA_API_KEY>",
"GEMINI_API_KEY": "<YOUR_GEMINI_API_KEY>",
"GITHUB_TOKEN": "<YOUR_GITHUB_TOKEN>",
"OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>"
}
}
}
}Конфигурация
ANTHROPIC_API_KEYСекретProvider key for codna_fix's planner — any one of ANTHROPIC_API_KEY (Anthropic), OPENAI_API_KEY (OpenAI/ChatGPT), or GEMINI_API_KEY (Gemini) works (or store one with `codna key set <provider>`). Every tool also requires the one-time free `codna login` device authorization before executing; introspection (initialize/tools/list) needs no credentials.
CODNA_API_KEYСекретCodna key from the one-time free `codna login` (device authorization, free community license). Required to execute any of the five tools; introspection (initialize/tools/list) needs none.
GEMINI_API_KEYСекретAlternative provider key (Gemini) for codna_fix's planner — see ANTHROPIC_API_KEY.
GITHUB_TOKENСекретWrite token, only for codna_fix with open_pr=true (opens a pull request) and codna_report_bug (files an issue).
OPENAI_API_KEYСекретAlternative provider key (OpenAI/ChatGPT) for codna_fix's planner — see ANTHROPIC_API_KEY.
| Название | Описание | Тип |
|---|---|---|
| ANTHROPIC_API_KEY | Provider key for codna_fix's planner — any one of ANTHROPIC_API_KEY (Anthropic), OPENAI_API_KEY (OpenAI/ChatGPT), or GEMINI_API_KEY (Gemini) works (or store one with `codna key set <provider>`). Every tool also requires the one-time free `codna login` device authorization before executing; introspection (initialize/tools/list) needs no credentials. | Секрет |
| CODNA_API_KEY | Codna key from the one-time free `codna login` (device authorization, free community license). Required to execute any of the five tools; introspection (initialize/tools/list) needs none. | Секрет |
| GEMINI_API_KEY | Alternative provider key (Gemini) for codna_fix's planner — see ANTHROPIC_API_KEY. | Секрет |
| GITHUB_TOKEN | Write token, only for codna_fix with open_pr=true (opens a pull request) and codna_report_bug (files an issue). | Секрет |
| OPENAI_API_KEY | Alternative provider key (OpenAI/ChatGPT) for codna_fix's planner — see ANTHROPIC_API_KEY. | Секрет |
Автоматические проверки
Запущено 12 нояб. 2026 г.Полный отчёт →Прошло наши автоматизированные проверки. Это не аудит безопасности: изучите код и предоставьте серверу минимально необходимый доступ. Как работают проверки
- Связанный и доступный исходный репозиторийПройдено
- Open source лицензия (OSI)Пройдено
- Коммит или релиз за последний годПройдено
- Имя пакета не похоже на популярный пакетПройдено
- Удаленная конечная точка использует HTTPSНе проверялось
- Деструктивные инструменты помеченыНе проверялось
- Нет скрытых инструкций для моделиПройдено
- Нет критических предупреждений в пакете или его зависимостяхПройдено
README
Открыть на GitHubCodna
Understand. Fix. Evolve.
Agents read your code. Codna understands it.
Codna maps a repository before it spends a token. It then reviews pull requests, fixes bugs and
proves which scanner findings are reachable. The same codna command runs on your machine, in the
GitHub Action and behind the GitHub App.
Runs on your machine or your cloud. Your code never leaves without your key.
Install
pip install codna # or: pipx install codna · uv tool install codna
codna --version
Python 3.12–3.13. Wheels for macOS on Apple silicon and Linux x86_64. git on your PATH.
Nothing else to install: no Node, Bun, Docker or server. The agent runtime ships inside the wheel.
Local commands need no Codna key. fix and review use your own model provider key, stored in
the OS keychain and never printed:
codna key set anthropic # also: openai, gemini, google, groq, mistral, openrouter, xai, cursor
Commands
codna triage . --issue "checkout total is wrong" # suspect files. Deterministic. 0 LLM tokens.
codna review . --pr 123 --post # findings with a verdict on the pull request
codna fix . --tests --apply --max-iterations 3 # patch, re-run your tests, re-fix until green
codna fix <git url> --ref <sha> --issue "…" --open-pr # push a branch and open a pull request
codna secure . --from-sarif results.sarif # which scanner findings are reachable. 0 LLM tokens.
codna fix prints the root cause, the impacted symbols, the blast radius, its confidence and a
regression risk. --open-pr needs a git URL and a GitHub write token. codna review posts one
inline comment per finding with severity, category and a suggestion block, and an Approve when the
diff is clean at medium and high. codna secure reads SARIF 2.1.0 from CodeQL, Semgrep, Snyk,
Trivy or any other scanner.
Other commands: init, status, doctor, login, key, impact, memory export, report.
Full reference: docs.codna.ai/reference/cli.
MCP server
Run Codna as a Model Context Protocol server over stdio — the same engine the CLI uses, inside Cursor, Claude Desktop, or your own agent:
pipx install "codna[mcp]" # or: pip install "codna[mcp]"
codna mcp # serve over stdio
codna mcp install --client cursor # optional: write the client config for you (or --client claude)
Five tools, each returning JSON; a failure comes back as codna_<tool> error: … text and never
crashes the server:
| Tool | What it does | Needs |
|---|---|---|
codna_triage |
Understand a repo and locate the code relevant to an issue. Deterministic, 0 LLM tokens. | free codna login |
codna_secure |
Prove which SARIF scanner findings (CodeQL, Semgrep, Snyk, Trivy) are reachable. Read-only, 0 LLM tokens. | free codna login |
codna_recall |
Recall code from local on-device memory — semantic + lexical search, fully offline. | free codna login (which also installs the on-device runtime) |
codna_fix |
Root-cause and plan a fix (read-only by default); with open_pr=true pushes a branch and opens a real PR. |
free codna login + provider key (BYOK; + GITHUB_TOKEN for open_pr=true) |
codna_report_bug |
File a bug, feature, or question to thyn-ai/feedback. | free codna login + GITHUB_TOKEN (else returns a pre-filled URL) |
Introspection (initialize/tools/list) needs no credentials. Executing any of the five tools
requires the one-time free community login (codna login — device authorization, free community
license) — fully offline thereafter. codna_fix additionally needs a provider key (BYOK, e.g.
ANTHROPIC_API_KEY); codna_report_bug needs GITHUB_TOKEN or it returns a pre-filled issue
URL; codna_recall additionally uses the on-device memory runtime that the same codna login
installs.
Full reference:
docs.codna.ai/guides/mcp.
Code memory
Code memory and recall run on your machine after a one-time free codna login (device
authorization), which also installs the signed on-device runtime. From then on, recall runs fully
offline: no key, no network calls. The optional
codna[memory] extra adds the on-device semantic reranker; without it, recall ranks lexically.
What leaves your machine
- Repository mapping, triage, recall and
impactrun offline. No model is involved. fixandreviewsend one issue-specific evidence bundle to the provider you chose, under your key. Not the repository.- Secret redaction is always on and cannot be turned off.
privacy.egress: fail-closedincodna.yamlrefuses to run tests without network denial and skips registry lookups during review.- Source distributions exclude runtime binaries, keys,
.envfiles and logs.
Links
- Homepage: https://codna.ai
- Documentation: https://docs.codna.ai
- Source (public mirror): https://github.com/thyn-ai/codna-cli
- Security: https://codna.ai/security
Вопросы о Codna MCP
Как добавить Codna MCP в Claude Code?
Выполните claude mcp add --env 'ANTHROPIC_API_KEY=<YOUR_ANTHROPIC_API_KEY>' --env 'CODNA_API_KEY=<YOUR_CODNA_API_KEY>' --env 'GEMINI_API_KEY=<YOUR_GEMINI_API_KEY>' --env 'GITHUB_TOKEN=<YOUR_GITHUB_TOKEN>' --env 'OPENAI_API_KEY=<YOUR_OPENAI_API_KEY>' codna-cli -- uvx codna в терминале. Добавьте --scope user, чтобы сервер был доступен во всех проектах.
Как добавить Codna MCP в Cursor?
Откройте ~/.cursor/mcp.json и добавьте сервер в mcpServers, используя конфигурацию Cursor из раздела установки выше.
Отправляет ли Codna весь мой репозиторий в LLM?
Нет, функции fix и review отправляют выбранному провайдеру только пакет данных, относящийся к конкретной проблеме, используя ваш ключ, а не весь репозиторий.
Как использовать Codna с Cursor или Claude Desktop?
Вы можете установить MCP server через pipx и использовать команду install для автоматической записи конфигурации клиента для Cursor или Claude.
Можно ли использовать Codna офлайн?
Да, инструменты маппинга репозитория, классификации, поиска (recall) и анализа влияния работают офлайн; поиск работает полностью локально после однократной авторизации.
Какие результаты сканирования может анализировать Codna?
Codna может подтвердить достижимость находок от CodeQL, Semgrep, Snyk, Trivy или любого другого сканера, предоставляющего формат SARIF 2.1.0.