Codna — repository intelligence MCP Server
by thyn-aiio.github.thyn-ai/codnav0.2.90
Repo intelligence: triage, fix PRs, SARIF reachability, recall. Free codna login to execute.
context tax
queued
security
queued
cold start
queued
freshness
Active4d ago
Install Codna — repository intelligence MCP server
Install in Claude Code
claude mcp add codna -e ANTHROPIC_API_KEY='<anthropic-api-key>' -e GITHUB_TOKEN='<github-token>' -e CODNA_API_KEY='<codna-api-key>' -- uvx codna mcpInstall in Cursor
{
"mcpServers": {
"codna": {
"command": "uvx",
"args": [
"codna",
"mcp"
],
"env": {
"ANTHROPIC_API_KEY": "<anthropic-api-key>",
"GITHUB_TOKEN": "<github-token>",
"CODNA_API_KEY": "<codna-api-key>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"codna": {
"command": "uvx",
"args": [
"codna",
"mcp"
],
"env": {
"ANTHROPIC_API_KEY": "<anthropic-api-key>",
"GITHUB_TOKEN": "<github-token>",
"CODNA_API_KEY": "<codna-api-key>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"codna": {
"type": "stdio",
"command": "uvx",
"args": [
"codna",
"mcp"
],
"env": {
"ANTHROPIC_API_KEY": "<anthropic-api-key>",
"GITHUB_TOKEN": "<github-token>",
"CODNA_API_KEY": "<codna-api-key>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"codna": {
"command": "uvx",
"args": [
"codna",
"mcp"
],
"env": {
"ANTHROPIC_API_KEY": "<anthropic-api-key>",
"GITHUB_TOKEN": "<github-token>",
"CODNA_API_KEY": "<codna-api-key>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| ANTHROPIC_API_KEY | — | yes | 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. |
| GITHUB_TOKEN | — | yes | Write token, only for codna_fix with open_pr=true (opens a pull request) and codna_report_bug (files an issue). |
| CODNA_API_KEY | — | yes | 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. |
Freshness
Active — last maintenance signal 4d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-10-06 · 4d ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-09-28 · 12d ago · official registry · v0.2.90
FAQ
›How do I install the Codna — repository intelligence MCP server in Claude Code?
Run: claude mcp add codna -e ANTHROPIC_API_KEY='<anthropic-api-key>' -e GITHUB_TOKEN='<github-token>' -e CODNA_API_KEY='<codna-api-key>' -- uvx codna mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Codna — repository intelligence require an API key?
Yes. It expects ANTHROPIC_API_KEY, GITHUB_TOKEN, CODNA_API_KEY, of which 3 are secrets.
›Can I use Codna — repository intelligence as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Codna — repository intelligence in the official MCP registry?
Yes, as io.github.thyn-ai/codna.