# Osnova

> Osnova is an open-source MCP server for developer tools. A deterministic tree-sitter code map for coding agents, with exact file and line over MCP. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, Windows
- **Website:** https://getosnova.dev
- **Repository:** https://github.com/getdomovoi/osnova
- **MCP Registry name:** io.github.getdomovoi/osnova
- **Categories:** developer tools
- **Listing updated:** 2026-11-16

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

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

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/osnova
