Install

Tech Debt MCP ships through multiple channels. Pick whichever matches your client.

npx (any MCP client)

The fastest path — no install, always the latest published version.

npx -y tech-debt-mcp@latest

Pin to a version if you want reproducibility:

npx -y tech-debt-mcp@2.0.2

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "tech-debt": {
      "command": "npx",
      "args": ["-y", "tech-debt-mcp@latest"]
    }
  }
}

Restart Claude Desktop after editing.

Claude Code plugin

The repository ships its own marketplace via .claude-plugin/marketplace.json. Install with:

/plugin marketplace add PierreJanineh/TechDebtMCP
/plugin install tech-debt-mcp@techdebtmcp

The plugin registers the MCP server via plugin.json → mcpServers, so there's nothing else to wire up.

MCPB bundle (Claude Desktop one-click)

Every GitHub Release attaches a tech-debt-mcp-<version>.mcpb artifact. Double-click to install in Claude Desktop — no Node toolchain needed on the host.

Global npm install (optional)

npm install -g tech-debt-mcp
tech-debt-mcp

Useful if you want to call the binary directly from custom scripts or another MCP client that expects a path.

What's next

• Browse the tool reference.
• Set up custom rules.
• Read the security model before running on untrusted projects.