# tech-debt-mcp

Ищет техдолг в 14 языках: от console.log и any до force unwrap в Swift. Ставится одной командой, работает через npx.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 7
- Автор: PierreJanineh
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/PierreJanineh/TechDebtMCP
- Обновлён: 2026-07-26
- HTML: https://affpapa.org/nevibecode/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`.

## Требования
- Нужно: Node.js (команды через npx)

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add tech-debt-mcp -- npx -y tech-debt-mcp
```

### Codex

**Командой платформы**
```bash
codex mcp add tech-debt-mcp -- npx -y tech-debt-mcp
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "tech-debt-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "tech-debt-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "tech-debt-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "tech-debt-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add tech-debt-mcp npx -y tech-debt-mcp
```

## Когда брать
- найти `console.log` и `debugger` перед мержем
- посчитать индекс техдолга по SQALE
- проверить SwiftUI-вью на утечки памяти и лишнюю вложенность
- разобрать манифесты зависимостей в npm, pip и Cargo
- задать свои проверки регулярками и погасить ложные срабатывания

## Примеры запросов агенту
- Просканируй папку `src` на техдолг и покажи только критические замечания
- Посчитай SQALE-рейтинг для этого репозитория
- Проверь `.techdebtrc.json` на корректность схемы

## Похожие
- [Front-End Checklist](https://affpapa.org/nevibecode/mcp/front-end-checklist.md) — MCP-сервер · ★ 74559
- [Codebase Memory](https://affpapa.org/nevibecode/mcp/codebase-memory.md) — MCP-сервер · ★ 47392
- [Serena MCP: the IDE for your agent](https://affpapa.org/nevibecode/mcp/serena-mcp-the-ide-for-your-agent.md) — MCP-сервер · ★ 30677
- [Repomix](https://affpapa.org/nevibecode/mcp/repomix.md) — MCP-сервер · ★ 29027
- [Repowise](https://affpapa.org/nevibecode/mcp/repowise.md) — MCP-сервер · ★ 7891
- [sem](https://affpapa.org/nevibecode/mcp/sem.md) — MCP-сервер · ★ 3422

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md