Skip to content
MCP server

Osnova

A deterministic tree-sitter code map for coding agents, with exact file and line over MCP

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, macOS, Linux
Runs
Locally
Version
0.12.0
Listing updated
1 day ago

About Osnova

Osnova is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

Osnova turns a repository into a symbol and call graph so an agent can ask who calls a function and get exact file and line numbers with the evidence for each caller. Calls it cannot tie to a definition are listed separately as unresolved, with same-name candidates, so a name match is not mistaken for a caller. The same commit gives byte-identical output, and it uses no embeddings or telemetry and stays offline apart from an explicit update check.

It covers twenty languages, seven of them (TypeScript, JavaScript, Python, Go, Rust, Java and C#) with deep adapters. The osnova_warp tool reports callers, reach counts and tests touching a symbol, and Osnova can re-index a diff afterwards to show what a change reached. An optional search gate blocks grep-style searches on indexed code until an osnova tool has been used.

It needs Node.js 22.13 or newer and installs with one prompt for supported agents.

Install

Run in a terminal

claude mcp add osnova -- npx -y @getdomovoi/osnova

Add to claude_desktop_config.json

{
  "mcpServers": {
    "osnova": {
      "command": "npx",
      "args": [
        "-y",
        "@getdomovoi/osnova"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "osnova": {
      "command": "npx",
      "args": [
        "-y",
        "@getdomovoi/osnova"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "osnova": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@getdomovoi/osnova"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "osnova": {
      "command": "npx",
      "args": [
        "-y",
        "@getdomovoi/osnova"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "osnova": {
      "command": "npx",
      "args": [
        "-y",
        "@getdomovoi/osnova"
      ]
    }
  }
}

Configuration

  • OSNOVA_CACHE_DIRCache directory; the only place osnova writes.

Tools this server provides (1)

Taken from the project documentation; the running server may differ.

osnova_warp
Callers, reach and tests for a symbol with exact file and line

What it does

Call graph answers
Callers with file, line and the evidence for each.
Unresolved evidence
Unconfirmed calls listed apart with a reason.
Deterministic output
Same commit, same answer, byte for byte.
Twenty languages
Seven with deep adapters.
Impact after edits
Re-indexes a diff to show what a change reached.
Optional search gate
Steers agents to osnova instead of grep.

Good for

  • Find all callers of a function before refactoring
  • Give an agent exact edit locations
  • Review the impact list of a change instead of the whole diff
  • Run code intelligence offline

Pricing

Open source

Apache-2.0; free

Prices change. Check getosnova.dev before you buy.

Osnova FAQ

Does it send my code anywhere?

The README says no telemetry and no network unless you run osnova update-check.

What does it need?

Node.js 22.13 or newer.

What licence?

Apache-2.0.

How do I set it up for Claude Code?

Run osnova setup claude --apply after installing the npm package.

Is Osnova free?

Yes. Osnova is open source, so you can use and self-host it for free.

How do I add Osnova to Claude Code?

Run this command in your terminal: claude mcp add osnova -- npx -y @getdomovoi/osnova

What are the best alternatives to Osnova?

The closest alternatives to Osnova are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Osnova

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools