Mirdan

Оркестратор качества ИИ-кода — экономит 30-45% ваших платных токенов на ИИ-кодинг за счет запуска локального уровня интеллекта, который берет на себя сортировку, линтинг, проверку типов, запуск тестов и валидацию, позволяя дорогим моделям, таким как Claude Opus, сосредоточиться на написании кода.

uv tool install mirdan                  # Install mirdan
mirdan llm setup                        # Auto-installs backend, downloads model, configures
mirdan init --claude-code               # or --cursor
# Done. Quality enforcement + local intelligence is now automatic.

Работает с Claude Code, Cursor IDE и Cursor CLI. Запускается на ноутбуках с 16 ГБ ОЗУ. Все данные остаются локально.

Локальный уровень интеллекта (новое в версии 2.0)

Mirdan 2.0 перекладывает рутинную работу на небольшую локальную модель (Gemma 4), работающую на вашем компьютере. Платная модель фокусируется исключительно на сложных рассуждениях и написании кода.

Перед написанием кода:

• Сортировка (Triage) — классифицирует задачи. Тривиальные задачи (исправление импорта, форматирование файла) никогда не доходят до платной модели. Ноль потраченных токенов.

• Исследование (Research) — собирает контекст кодовой базы, документацию библиотек и проектные соглашения локально (только для систем с 64 ГБ+ ОЗУ).

После написания кода:

• Запуск проверок (Check Runner) — локально запускает ruff, mypy, pytest. LLM анализирует вывод, автоматически исправляет линтинг и сообщает только о сложных сбоях.

• Умная валидация (Smart Validation) — 64 правила качества + фильтрация ложноположительных срабатываний с помощью LLM, группировка первопричин и предложения по исправлению.

• Автоисправление (Auto-Fix) — mirdan check --smart --fix применяет сгенерированные LLM исправления (поиск/замена) с последующей верификацией.

Быстрая настройка

mirdan llm setup              # Detects hardware, installs backend, downloads model, configures
mirdan init --claude-code     # or --cursor
mirdan llm status             # Verify it's working

Все работает локально. Никаких удаленных серверов. Никакие данные не покидают ваш компьютер.

Почему Mirdan?

ИИ-ассистенты пишут код быстро, но без ограничений они создают мусор: захардкоженные секреты, SQL-инъекции, функции-заглушки, несуществующие импорты, пустые блоки except и код, который выглядит правильно, но не работает в продакшене.

Mirdan исправляет это, перехватывая ваш рабочий процесс с ИИ в двух точках:

1. Перед написанием кода — enhance_prompt обогащает вашу задачу требованиями к качеству, ограничениями безопасности и стандартами конкретного фреймворка, чтобы ИИ с самого начала создавал лучший код.

2. После написания кода — validate_code_quality ловит то, что проскользнуло: 64 правила, охватывающие уязвимости безопасности, антипаттерны, специфичные для ИИ, и лучшие практики языка.

После установки он работает незаметно через хуки IDE. Вы просто пишете код как обычно.

Что он находит

Вот что mirdan помечает в одной функции типичного кода, сгенерированного ИИ:

API_KEY = "sk-proj-abc123456789"           # SEC001: hardcoded API key
def get_users(user_id):
    query = f"SELECT * FROM users WHERE id={user_id}"  # SEC005 + AI008: SQL injection
    result = eval(user_input)              # PY001: code injection via eval()
    data = requests.get(url, verify=False) # SEC007: SSL verification disabled
    try:
        process(data)
    except:                                # PY003: bare except
        pass

Результат: Оценка 0.0/1.0, 6 ошибок, 3 предупреждения. С помощью автоисправления mirdan автоматически устраняет 5 из них.

Что он добавляет в ваши промпты

Когда вы просите ИИ-ассистента «Создать эндпоинт аутентификации пользователя в FastAPI с JWT-токенами», enhance_prompt от mirdan обнаруживает, что это касается безопасности, и внедряет:

• Стандарты фреймворка: «Используйте Depends() с Annotated для типобезопасного внедрения зависимостей»

• Ограничения безопасности: «Проверьте, что секреты или учетные данные не захардкожены»

• Требования к качеству: «Используйте модели Pydantic для всех тел запросов и схем ответов»

• Шаги верификации: «Убедитесь, что обработка ошибок охватывает все асинхронные операции»

ИИ получает структурированное руководство вместо пустого промпта, создавая лучший код с первой попытки.

Быстрый старт

Установка

uv tool install mirdan                   # Install mirdan
mirdan llm setup                         # Auto-installs LLM backend + downloads model

# Optional extras:
uv tool install 'mirdan[ast]'            # + tree-sitter for TS/JS AST analysis
uv tool install 'mirdan[enterprise]'     # + truststore for corporate SSL inspection

# Upgrade:
uv tool upgrade mirdan

# Or with pip:
pip install mirdan

Настройка вашей IDE

mirdan init --claude-code    # Claude Code: hooks, rules, skills, agents
mirdan init --cursor         # Cursor: hooks, rules, AGENTS.md, BUGBOT.md
mirdan init --all            # Both IDEs

Это генерирует все необходимое — конфигурацию MCP-сервера, хуки качества, файлы правил и определения агентов. Когда включена LLM, хуки также настраивают локальную сортировку и запуск проверок. После инициализации ваша IDE автоматически:

1. Обогащает промпты требованиями к качеству перед выполнением задач по кодингу

2. Валидирует код на соответствие правилам безопасности и качества после каждого редактирования

3. Запускает финальный контроль качества перед завершением задачи

Использование из командной строки

mirdan validate --file src/auth.py     # Validate a file
mirdan validate --staged               # Validate git staged changes
mirdan fix --file src/auth.py          # Auto-fix violations (pattern-based)
mirdan check --smart                   # Run lint + typecheck + test with LLM analysis
mirdan check --smart --fix src/        # Run checks AND auto-fix with local LLM
mirdan gate                            # CI/CD quality gate (exit 0 or 1)
mirdan scan --dependencies             # Check deps for known CVEs
mirdan scan --directory src/           # Discover codebase conventions
mirdan llm setup                       # Configure local LLM
mirdan llm status                      # Show LLM health, model, hardware
mirdan llm metrics                     # Token savings dashboard

Как это работает

Mirdan — это MCP-сервер — он подключается к ИИ-ассистентам (Claude Code, Cursor, Claude Desktop или любому MCP-клиенту) и предоставляет инструменты для обеспечения качества.

┌──────────────────────────────────────────────────┐
│  Your AI Assistant (Claude Code / Cursor / etc)  │
│                                                  │
│  1. You type a coding task                       │
│  2. Hook triages task via local LLM ────┐        │
│  3. AI generates code with guidance     │        │
│  4. Hook runs lint/typecheck/test ◄─────┘        │
│  5. AI fixes only complex issues                 │
│  6. Quality gate passes → task complete          │
└──────────────────────────────────────────────────┘
         │                        ▲
         ▼                        │
┌──────────────────────────────────────────────────┐
│  Mirdan MCP Server + Local Intelligence Layer    │
│                                                  │
│  MCP Tools (unchanged):                          │
│  enhance_prompt         → Quality requirements   │
│  validate_code_quality  → 64 rules + LLM enrich │
│  validate_quick         → Fast security checks   │
│  get_quality_standards  → Language/framework ref  │
│  get_quality_trends     → Historical analysis    │
│  scan_dependencies      → CVE detection (OSV)    │
│  scan_conventions       → Convention discovery   │
│                                                  │
│  Local LLM (Gemma 4, runs on your machine):      │
│  Triage          → Classify tasks, save tokens   │
│  Check Runner    → Run ruff/mypy/pytest locally  │
│  Smart Validator → FP filtering, root causes     │
│  Auto-Fix        → Search/replace code fixes     │
│  HTTP Sidecar    → <5ms hook integration         │
└──────────────────────────────────────────────────┘

Правила валидации

Mirdan поставляется с 64 правилами в 10 категориях. Внешние сервисы не требуются — все правила работают локально.

Качество ИИ (AI001–AI008)

Правила, которые ловят паттерны, уникальные для кода, сгенерированного ИИ:

Безопасность (SEC001–SEC014)

Специфичные для языка

Плюс ARCH001–003 / TSARCH001–004 (длина функции, длина файла, глубина вложенности, отсутствующие типы возвращаемых значений), RAG001–002 (перекрытие чанков, устаревшие загрузчики).

Правила Python PY001–PY004 используют валидацию на основе AST — устраняя ложные срабатывания из строк и комментариев. Когда установлен mirdan[ast], архитектурные проверки TypeScript/JavaScript используют tree-sitter для точного анализа длины функции, глубины вложенности и типов возвращаемых значений.

32 правила поддерживают автоматические исправления через mirdan fix.

Поддержка языков и фреймворков

Языки: Python, TypeScript, JavaScript, Go, Java, Rust

33 стандарта фреймворков — mirdan знает идиомы, лучшие практики и распространенные ошибки для каждого из них:

React, React Native, Next.js, Nuxt, Vue, SvelteKit, Astro, Flutter, Tailwind, FastAPI, Django, Express, NestJS, Echo, Gin, Spring Boot, Micronaut, Quarkus, Drizzle, Neo4j, Supabase, Convex, Pinecone, Qdrant, Milvus, Weaviate, ChromaDB, FAISS, LangChain, LangGraph, CrewAI, DSPy, tRPC

Когда enhance_prompt обнаруживает фреймворк, он внедряет специфичные для него требования к качеству (например, «Используйте Depends() с Annotated» для FastAPI, «Предпочитайте серверные компоненты» для Next.js).

Профили качества

Профили настраивают уровни контроля по 8 измерениям. Выберите тот, который соответствует вашему проекту:

Шкала: 0.0–0.3 разрешительный | 0.3–0.7 умеренный | 0.7–1.0 строгий

mirdan init --quality-profile enterprise
mirdan profile apply fintech          # Change later
mirdan profile suggest                # Let mirdan recommend one

Интеграция с IDE

Claude Code

mirdan init --claude-code

Генерирует .mcp.json, хуки, правила, 7 навыков (/code, /debug, /review, /plan, /quality, /scan, /gate) и 5 агентов (quality-gate, security-audit, test-quality, convention-check, architecture-reviewer).

Уровни строгости хуков контролируют, насколько агрессивно вмешивается mirdan:

Cursor

mirdan init --cursor

Генерирует полную интеграцию с Cursor 2.x:

• Правила — .cursor/rules/*.mdc (всегда включены, безопасность, планирование, отладка, агент, специфичные для языка)

• Хуки — .cursor/hooks.json с хуками типа промпта + типа команды, скрипты .cursor/hooks/*.sh

• Субагенты — .cursor/agents/*.md (quality-validator, security-scanner, test-auditor, slop-detector, architecture-reviewer)

• Навыки — .cursor/skills/*/SKILL.md, следующие стандарту навыков агентов (code, debug, review, plan, quality, scan, gate)

• Команды — .cursor/commands/*.md слэш-команды (/code, /debug, /review, /plan, /quality, /scan, /gate)

• Окружение — .cursor/environment.json для сред Cloud Agent

• Конфигурация — .cursor/mcp.json, AGENTS.md, BUGBOT.md

В Cursor есть ограничения на количество инструментов. Установите MIRDAN_TOOL_BUDGET, чтобы контролировать, какие инструменты доступны (2 = только валидация, 5+ = все инструменты).

Claude Desktop / Любой MCP-клиент

Добавьте в вашу конфигурацию MCP:

{
  "mcpServers": {
    "mirdan": {
      "command": "uvx",
      "args": ["mirdan"]
    }
  }
}

Корпоративные сети (Netskope, Zscaler, прокси Artifactory): передайте переменные окружения для SSL и загрузки моделей:

{
  "mcpServers": {
    "mirdan": {
      "command": "uvx",
      "args": ["mirdan"],
      "env": {
        "MIRDAN_HF_ENDPOINT": "https://artifactory.corp.com/hf",
        "MIRDAN_HF_TOKEN": "your-artifactory-token",
        "MIRDAN_SSL_CERT_FILE": "/path/to/corporate-ca-bundle.crt"
      }
    }
  }
}

Корпоративное развертывание

Для обеспечения соблюдения правил в масштабах всей организации через управляемую конфигурацию:

macOS: `/Library/Application Support/ClaudeCode/managed-m