Trace MCP Server

Framework-aware code intelligence MCP server — 60 framework integrations, 81 languages, up to 99% token reduction

Local serverstdioPython

What is the Trace MCP MCP server?

Framework-aware code intelligence MCP server — 60 framework integrations, 81 languages, up to 99% token reduction. Exposed over MCP by the trace mcp mcp server, that capability becomes something an assistant can invoke while it works, not something you go and do afterwards.

What it actually does

AI agents recompute the same work. trace-mcp makes them reuse instead.

  • Lower cost — — fewer tokens per successful answer, on average and at peak
  • Lower latency — — fewer sequential tool calls, fewer round-trips to the model
  • Higher accuracy — — less noise in context means fewer hallucinations and stronger first-response correctness
  • Production stability — — context that scales with project size, not against it

Its toolset

Everything the assistant can do here goes through one of these:

  • macOS — trace-mcp--arm64-mac.zip (Apple Silicon) or trace-mcp--mac.zip (Intel). Unzip and drag trace-mcp.app into /Applications
  • Windows — run trace-mcp.Setup..exe
  • Graph — aware task context** — describe a dev task → get the optimal code subgraph (execution paths, tests, types) + relevant past decisions, adapted to
  • init — configures your MCP client (Claude Code, Cursor, Windsurf, Claude Desktop, …), installs the guard hook, adds routing rules to ~/.claude/CLAUDE.md
  • add — detects frameworks, creates the per-project index, registers the project. Re-run in every project you want trace-mcp to understand
  • Workload — Typical reduction

Adding it to your client

trace-mcp on npm is all you need. Most clients run it directly, so configuration is a few lines and a restart.

When to reach for it

This sits in the developer tooling group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Trace MCP's toolset — macOS, Windows, Graph and 3 more — is a fair guide to whether it matches your workflow. It is maintained by nikolai-vysotskyi; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Caveats

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the trace mcp mcp server does with a few real requests.

Available tools

ToolWhat it does
macOStrace-mcp-<version>-arm64-mac.zip (Apple Silicon) or trace-mcp-<version>-mac.zip (Intel). Unzip and drag trace-mcp.app into /Applications.
Windowsrun trace-mcp.Setup.<version>.exe.
Graphaware task context** — describe a dev task → get the optimal code subgraph (execution paths, tests, types) + relevant past decisions, adapted to bugfix/feature/refactor intent
initconfigures your MCP client (Claude Code, Cursor, Windsurf, Claude Desktop, …), installs the guard hook, adds routing rules to ~/.claude/CLAUDE.md.
adddetects frameworks, creates the per-project index, registers the project. Re-run in every project you want trace-mcp to understand.
WorkloadTypical reduction

How to install the Trace MCP MCP server

{
  "mcpServers": {
    "trace": {
      "command": "npx",
      "args": ["-y", "trace-mcp"]
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Example prompts to try

  • Use Trace MCP to macOS.
  • Use Trace MCP to Windows.
  • Use Trace MCP to Graph.

Frequently asked questions

It connects Trace MCP to MCP-compatible AI assistants such as Claude and Cursor, exposing 6 tools (macOS, Windows, Graph, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Trace MCP directly.