Osnova MCP server

Osnova

A deterministic code map for AI coding agents. Osnova indexes a repository into a symbol and call graph with tree-sitter, then serves it to any MCP client or from the command line. Same input, same output, byte for byte. No embeddings, no telemetry, and no network connection unless you type osnova update-check. Twenty languages, seven of them (TypeScript, JavaScript, Python, Go, Rust, Java, C#) with deep adapters.

Osnova is the Slavic word for base or foundation. That is the job: give an agent solid ground to stand on before it edits code.

Quick start

Node.js 22.13 or newer. Serve a repository to any MCP client:

npx -y @getdomovoi/osnova mcp --workspace /path/to/repo

After npm install -g @getdomovoi/osnova, one command per kind of agent: claude wires Claude Code (MCP entry, session, prompt and stop hooks, and the skill); agents wires every installed harness that reads AGENTS.md (Codex, OpenCode, Kilo, Pi, Cursor), each with its hooks, plugin or extension, plus one shared skill in ~/.agents/skills/. Each previews its changes; --apply writes them, backing up every file it changes.

osnova setup claude --apply
osnova setup agents --apply

Or add the MCP entry by hand; replace osnova with npx -y @getdomovoi/osnova when there is no global install.

{ "mcpServers": { "osnova": { "command": "osnova", "args": ["mcp"] } } }

What you get back

Shortened. The full README is on GitHub.