ChangeMap MCP server

Local STDIO MCP adapter over the ChangeMap CLI --json contract. No graph logic, no cloud, no VS Code dependency.

Requires Node.js 22+ and @changemap/cli (declared dependency).

AI agent → changemap-mcp (stdio) → changemap CLI --json → core → SQLite

Cursor (public install)

After @changemap/mcp is on the public npm registry. Do not point this at a ChangeMap git checkout.

{
  "mcpServers": {
    "changemap": {
      "command": "npx",
      "args": ["-y", "@changemap/mcp"],
      "env": {
        "CHANGEMAP_NODE": "node"
      }
    }
  }
}

CHANGEMAP_NODE must point at Node 22+, not Cursor’s Electron binary. Optional: CHANGEMAP_CLI (absolute path to dist/index.js), CHANGEMAP_WORKSPACE.

After npm install -g @changemap/mcp, "command": "changemap-mcp" is equivalent.

From this monorepo after npm run build (maintainers only):

{
  "mcpServers": {
    "changemap": {
      "command": "node",
      "args": ["packages/mcp/dist/index.js"]
    }
  }
}

Do not write logs to stdout; the MCP protocol uses stdin/stdout.

Tools: changemap_status, changemap_outline, changemap_impact, changemap_dependents, changemap_dependencies. Impact defaults to compact JSON; pass format: "full" for the IDE contract. Initialize includes agent workflow instructions. No source leaves the machine.

This package is proprietary. Source is private. License: see LICENSE (proposed / not lawyer-reviewed). First public version: 0.1.0-rc.1.

Benchmarks (development)

From the repo root: npm run benchmark. That script is not included in the published tarball.