tech-debt-mcp — MCP-сервер для Claude Code: анализ техдолга
Ищет техдолг в 14 языках: от console.log и any до force unwrap в Swift. Ставится одной командой, работает через npx.
claude mcp add tech-debt-mcp -- npx -y tech-debt-mcpЧто делает tech-debt-mcp
Сервер отдаёт агенту 16 инструментов и 2 ресурса для разбора кода. Проверки разложены по языкам: в JavaScript это console.log, debugger и var, в TypeScript — any и @ts-ignore, в Python — голый except и print, в Rust — unwrap и unsafe. Отдельный набор для SwiftUI: вложенность вью, утечки памяти, работа с состоянием и конкурентность.
Метрику долга считает по SQALE со шкалой от A до E. Есть разбор манифестов зависимостей в 10 экосистемах, включая npm, pip, Cargo, Go Modules и Composer. Свои проверки задаются регулярками в .techdebtrc.json, а ложные срабатывания гасятся комментарием // techdebt-ignore-next-line. Результаты фильтруются по серьёзности, категории или языку.
Сервер запускается через npx, поэтому в системе нужен Node.js. Ставить из исходников не придётся: команда тянет опубликованный пакет. Для Claude есть и второй путь — плагин из маркетплейса репозитория, он под капотом выполняет ту же команду npx -y tech-debt-mcp@latest.
Какие задачи решает
- найти
console.logиdebuggerперед мержем - посчитать индекс техдолга по SQALE
- проверить SwiftUI-вью на утечки памяти и лишнюю вложенность
- разобрать манифесты зависимостей в npm, pip и Cargo
- задать свои проверки регулярками и погасить ложные срабатывания
Примеры запросов агенту
- Просканируй папку
srcна техдолг и покажи только критические замечания - Посчитай SQALE-рейтинг для этого репозитория
- Проверь
.techdebtrc.jsonна корректность схемы
Как установить tech-debt-mcp
Командой платформы
claude mcp add tech-debt-mcp -- npx -y tech-debt-mcpКомандой платформы
codex mcp add tech-debt-mcp -- npx -y tech-debt-mcpФайл настроек
{
"mcpServers": {
"tech-debt-mcp": {
"command": "npx",
"args": [
"-y",
"tech-debt-mcp"
]
}
}
}Файл настроек
{
"servers": {
"tech-debt-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"tech-debt-mcp"
]
}
}
}Командой платформы
gemini mcp add tech-debt-mcp npx -y tech-debt-mcpПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о tech-debt-mcp
Как установить tech-debt-mcp в Claude Code?
Выполните claude mcp add tech-debt-mcp -- npx -y tech-debt-mcp. Сервер запустится через npx, поэтому Node.js должен быть в системе.
Что делает tech-debt-mcp?
Разбирает код на предмет техдолга: качество, потенциальные уязвимости, поддерживаемость. Считает метрику по SQALE и выдаёт список замечаний с приоритетами.
Какие языки поддерживаются?
JavaScript, TypeScript, Python, Java, Swift, Kotlin, Objective-C, C++, C, C#, Go, Rust, Ruby и PHP. Для Swift есть отдельные проверки SwiftUI.
