MCP Server

state-trace MCP Server

Name: state-trace MCP Server
Author: io.github.razroo

io.github.razroo/state-trace

Repository Registry

What is the state-trace MCP server?

Bounded working memory for coding agents — typed nodes, current-vs-stale state, MCP-mountable.

How to install state-trace

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

STATE_TRACE_STORAGE_PATH
Path to the SQLite or JSON file backing the working-memory graph. .db/.sqlite/.sqlite3 = SQLite (recommended); other = JSON. Defaults to ~/.state-trace/memory.db.
STATE_TRACE_NAMESPACE
Namespace to scope reads and writes (e.g. the repo slug). Nodes without a namespace remain visible to all namespaces.
STATE_TRACE_CAPACITY_LIMIT
Working-memory budget in capacity units. Default 256.

Claude Desktop

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

{
  "mcpServers": {
    "state-trace": {
      "command": "uvx",
      "args": [
        "state-trace",
        "extras",
        "[mcp]"
      ],
      "env": {
        "STATE_TRACE_STORAGE_PATH": "<YOUR_STATE_TRACE_STORAGE_PATH>",
        "STATE_TRACE_NAMESPACE": "<YOUR_STATE_TRACE_NAMESPACE>",
        "STATE_TRACE_CAPACITY_LIMIT": "<YOUR_STATE_TRACE_CAPACITY_LIMIT>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "state-trace": {
      "command": "uvx",
      "args": [
        "state-trace",
        "extras",
        "[mcp]"
      ],
      "env": {
        "STATE_TRACE_STORAGE_PATH": "<YOUR_STATE_TRACE_STORAGE_PATH>",
        "STATE_TRACE_NAMESPACE": "<YOUR_STATE_TRACE_NAMESPACE>",
        "STATE_TRACE_CAPACITY_LIMIT": "<YOUR_STATE_TRACE_CAPACITY_LIMIT>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "state-trace": {
      "command": "uvx",
      "args": [
        "state-trace",
        "extras",
        "[mcp]"
      ],
      "env": {
        "STATE_TRACE_STORAGE_PATH": "<YOUR_STATE_TRACE_STORAGE_PATH>",
        "STATE_TRACE_NAMESPACE": "<YOUR_STATE_TRACE_NAMESPACE>",
        "STATE_TRACE_CAPACITY_LIMIT": "<YOUR_STATE_TRACE_CAPACITY_LIMIT>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "state-trace": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "state-trace",
        "extras",
        "[mcp]"
      ],
      "env": {
        "STATE_TRACE_STORAGE_PATH": "<YOUR_STATE_TRACE_STORAGE_PATH>",
        "STATE_TRACE_NAMESPACE": "<YOUR_STATE_TRACE_NAMESPACE>",
        "STATE_TRACE_CAPACITY_LIMIT": "<YOUR_STATE_TRACE_CAPACITY_LIMIT>"
      }
    }
  }
}

Claude Code

claude mcp add state-trace --env STATE_TRACE_STORAGE_PATH=<YOUR_STATE_TRACE_STORAGE_PATH> --env STATE_TRACE_NAMESPACE=<YOUR_STATE_TRACE_NAMESPACE> --env STATE_TRACE_CAPACITY_LIMIT=<YOUR_STATE_TRACE_CAPACITY_LIMIT> -- uvx state-trace extras [mcp]