tech-debt-mcp — Claude Code MCP server: tech debt analysis
Scans 14 languages for tech debt, from stray console.log calls to Swift force unwraps, and scores the result on the SQALE scale.
claude mcp add tech-debt-mcp -- npx -y tech-debt-mcpWhat tech-debt-mcp does
The server hands your agent 16 tools and 2 resources for code inspection. Checks are grouped by language: JavaScript gets console.log, debugger and var, TypeScript gets any and @ts-ignore, Python gets bare except and print, Rust gets unwrap and unsafe. SwiftUI has its own set covering view nesting, memory leaks, state handling and concurrency.
Debt is scored with SQALE on an A-to-E scale. Dependency manifests are parsed across 10 ecosystems, npm, pip, Cargo, Go Modules and Composer among them. You can add pattern checks of your own through regex in .techdebtrc.json, and silence false positives with a // techdebt-ignore-next-line comment. Filtering works by severity, category or language.
It runs through npx, so Node.js has to be present. Nothing gets built from source: the command pulls the published package. Claude users have a second route, a plugin from the repository marketplace that runs npx -y tech-debt-mcp@latest underneath.
What it helps with
- catch leftover
console.loganddebuggercalls before a merge - get a SQALE debt rating for a repository
- check SwiftUI views for leaks and deep nesting
- read dependency manifests across npm, pip and Cargo
- add custom regex checks and suppress false positives
Example prompts for the agent
- Scan the
srcfolder for tech debt and list only critical findings - Compute the SQALE rating for this repository
- Validate
.techdebtrc.jsonagainst the schema
How to install tech-debt-mcp
Platform CLI
claude mcp add tech-debt-mcp -- npx -y tech-debt-mcpPlatform CLI
codex mcp add tech-debt-mcp -- npx -y tech-debt-mcpConfig file
{
"mcpServers": {
"tech-debt-mcp": {
"command": "npx",
"args": [
"-y",
"tech-debt-mcp"
]
}
}
}Config file
{
"servers": {
"tech-debt-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"tech-debt-mcp"
]
}
}
}Platform CLI
gemini mcp add tech-debt-mcp npx -y tech-debt-mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about tech-debt-mcp
How do I install tech-debt-mcp in Claude Code?
Run claude mcp add tech-debt-mcp -- npx -y tech-debt-mcp. The server starts through npx, so Node.js must be available.
What does tech-debt-mcp do?
It inspects code for debt: quality problems, possible vulnerabilities and maintainability issues. It also computes a SQALE score and returns prioritised findings.
Which languages are supported?
JavaScript, TypeScript, Python, Java, Swift, Kotlin, Objective-C, C++, C, C#, Go, Rust, Ruby and PHP. Swift has extra SwiftUI checks.
