# trovex

> trovex is an open-source MCP server for developer tools. Serve coding agents one canonical doc per query instead of rereading the repo. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, macOS, Linux, Windows
- **Website:** https://trovex.dev
- **Repository:** https://github.com/tsukumohq/trovex
- **MCP Registry name:** io.github.TsukumoHQ/trovex
- **Categories:** developer tools, knowledge and memory
- **Listing updated:** 2026-11-16

## About

Agents tend to reread a repository's markdown every session to work out which file is current, and then answer from a guess. Trovex indexes those files and, for each question, returns the single current doc as a path:line pointer with a freshness marker of canonical, stale or duplicate, plus just the section that answers it. Agents can also write what they learn back through one shared point so teammates read the same source.

Six MCP tools are described: trovex, trovex_read and trovex_search are read-only, while trovex_write, trovex_tag and trovex_delete change only trovex's own doc store. It runs no shell commands and never writes to your source files. Everything is local, with vectors in SQLite and ONNX embeddings, so there is no cloud, no API key and no network call to answer a query.

The authors claim about 60 percent fewer tokens on doc lookups, measured at equal task success on their own repo with a median of 69 percent and a range of roughly 41 to 81 percent across repos (n=26, LLM-judged), and say it varies by repo. It is in public beta under AGPL-3.0-or-later and has a savings dashboard.

## Features

- **Canonical doc lookup:** Returns one current doc as a path:line pointer.
- **Freshness markers:** Labels results canonical, stale or duplicate.
- **Section-level answers:** Serves only the part of a file that answers.
- **Shared write-back:** Agents record learnings in one shared store.
- **Local-first:** SQLite vectors and ONNX embeddings; no cloud.
- **Savings dashboard:** Shows tokens saved at localhost:8765/savings.

## Good for

- Stop agents rereading the same markdown each session
- Find the current runbook for rolling back a deploy
- Share what one agent learned with teammates' agents
- Measure token savings on doc lookups

## Install

### Claude Code (Terminal)

```sh
claude mcp add trovex -- uvx trovex
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "trovex": {
      "command": "uvx",
      "args": [
        "trovex"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "trovex": {
      "command": "uvx",
      "args": [
        "trovex"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "trovex": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "trovex"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "trovex": {
      "command": "uvx",
      "args": [
        "trovex"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "trovex": {
      "command": "uvx",
      "args": [
        "trovex"
      ]
    }
  }
}
```

## Tools

- `trovex`: Returns the single canonical doc for a question.
- `trovex_read`: Read a doc section.
- `trovex_search`: Search the indexed docs.
- `trovex_write`: Write to trovex's own doc store.
- `trovex_tag`: Tag a doc in the store.
- `trovex_delete`: Delete from trovex's doc store.

## FAQ

### Does anything leave my machine?

No. The README says no cloud, no API keys and no network call to answer a query.

### Can it modify my source files?

No. Its write tools change only trovex's own doc store.

### How much does it save?

About 60 percent fewer tokens on doc lookups in the authors' own measurement; it varies by repo.

### What licence is it?

AGPL-3.0-or-later.

### Is trovex free?

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

### How do I add trovex to Claude Code?

Run this command in your terminal: claude mcp add trovex -- uvx trovex

### What are the best alternatives to trovex?

The closest alternatives to trovex 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.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.

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