Topos MCP Server

by krv-labs Your server? Claim it

local only

Topos runs on your own machine — the client starts it, so there is no endpoint to ping. 971 installs a week from pypi. Last commit 30 Oct 2026.

Structural code-quality tools for AI coding agents.

Installs per day peak 612 · avg 200 · -42% w/w

a month agotoday

971

Installs / week

pypi · topos-mcp

Stars

23 open issues

30 Oct 2026

Last commit

from GitHub

BSD-3-Clause

License

Rust

What the code does

We read the source, 2 d ago · rules 995398eba69f

Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

Builds a file path from a variable extensions/vscode/src/extension.ts:598, extensions/vscode/src/runtime.ts:79

        : path.join(workspaceRoot, evaluatePath);

Image downloads and pipes straight to shell Dockerfile:48

    && curl -fsSL https://deb.nodesource.com/setup_20.x | bash - \

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

This code can reach further than it looks

We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

claude mcp add topos -- uvx topos-mcp

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "topos": {
      "command": "uvx",
      "args": [
        "topos-mcp"
      ]
    }
  }
}

~/.codex/config.toml

[mcp_servers.topos]
command = "uvx"
args = ["topos-mcp"]

.cursor/mcp.json

{
  "mcpServers": {
    "topos": {
      "command": "uvx",
      "args": [
        "topos-mcp"
      ]
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "topos": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "topos-mcp"
      ]
    }
  }
}

Alternatives to Topos

same job, measured the same way

Skeletongraph

by yashdoke7

Zero-LLM structural code retrieval for AI coding agents, served over MCP.

102 installs/wk local only

Madeby

by madebyfyi

Disclose AI authorship of code per the ACO standard — tools for AI coding agents.

266 installs/wk local only

Forensic Deepdive

by dhevenddra

Persistent code knowledge graph + 9 composite MCP tools for AI coding agents.

86 installs/wk local only

Itamos MCP Tools

by itamos-technologia

Code-map tools for AI agents: see a repo's structure first, then edit only what matters.

answering

Constellation

by shiftinbits

Code Intelligence Platform for AI Coding Agents

311 installs/wk local only

gograph

by ozgurcd

Local Go repository call graphs and structural analysis for coding agents over stdio.

local only

TokenSaver

by byggarepop

Structural warm start for AI coding agents in .NET: cheap Roslyn signature maps of C#/.NET files.

local only

Scopewalker MCP

by timohaa

Codebase analysis tools for AI agents: complexity, prop drilling, doc coverage, code smells.

498 installs/wk local only

Topos — questions

Answers built from our own checks of this server.

Why is there no uptime for Topos?

Topos runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the pypi package topos-mcp was installed 971 times last week.

How do I connect Topos?

Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It runs locally, so the command pulls topos-mcp straight from pypi; nothing to host, nothing to sign up for.

How many people use Topos?

The pypi package topos-mcp was installed 971 times in the last week. Week over week that is -42%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.

Is Topos open source?

Yes — it is published under the BSD-3-Clause licence, written in Rust, 29 stars on GitHub and 23 open issues. The source link is on this page, so you can read exactly what it does with your data before you connect it.