🛡️ Scan Your AI Toolkit

Инструменты управления ИИ с открытым исходным кодом. Каждый из них работает автономно как MCP-сервер или CLI — вместе они образуют сеть управления.

scan_your_ai_toolkit MCP server

CodeQL npm scope License MCP Conformance PRs Welcome

Создано Maiife — корпоративная панель управления ИИ.

Инструменты

Пакет	Описание	Опубликовано
`@maiife-ai-pub/shared`	Общие типы и форматировщики, используемые всеми пакетами набора	✅
`@maiife-ai-pub/probe`	Сканер ИИ-среды — обнаружение расширений IDE, MCP-серверов, фреймворков агентов, API-ключей, локальных моделей	✅
`@maiife-ai-pub/mcp-audit`	Сканер безопасности MCP-серверов — оценка конфигураций по правам доступа, чувствительности данных, радиусу поражения	✅
`@maiife-ai-pub/ai-stack`	"Какой у вас ИИ-стек?" — профильная карточка вашего ИИ-инструментария, которой можно поделиться	✅
`@maiife-ai-pub/mcp-doctor`	Проверка работоспособности и автоисправление MCP — аналог brew doctor для вашей настройки MCP	✅
`@maiife-ai-pub/ai-journal`	Личный дневник использования ИИ — отслеживайте, как вы используете ИИ, и получайте рефлексивные инсайты	✅
`@maiife-ai-pub/context-sync`	Синхронизация памяти ИИ между инструментами — один context.json, синхронизированный с Cursor, Claude, MCP	✅
`@maiife-ai-pub/prompt-score`	Анализатор качества промптов — оценка, улучшение и линтинг ваших ИИ-промптов	✅
`@maiife-ai-pub/eval`	Механизм оценки LLM-как-судья — оценка результатов работы агентов с помощью структурированных рубрик	✅
`@maiife-ai-pub/trace`	Трассировщик рабочих процессов агентов — отслеживание, просмотр и анализ этапов выполнения	✅
`@maiife-ai-pub/cost`	Калькулятор расходов на ИИ + оптимизатор — единый отчет о затратах по всем поставщикам	✅
`@maiife-ai-pub/prompt-craft`	Геймифицированный коуч по промптам — уровни, серии, значки за улучшение промптов	✅
`@maiife-ai-pub/sub-audit`	Аудитор личных подписок на ИИ — поиск лишних трат в ваших расходах на ИИ	✅
`@maiife-ai-pub/model-match`	Персональный рекомендатель моделей — поиск лучшей модели для ВАШИХ задач	✅
`@maiife-ai-pub/weekly-ai-report`	Еженедельный обзор ИИ — Spotify Wrapped для вашего использования ИИ, еженедельно	✅

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

# Scan your AI environment
npx @maiife-ai-pub/probe scan

# Audit your MCP server security
npx @maiife-ai-pub/mcp-audit scan

# Generate your AI Stack profile card
npx @maiife-ai-pub/ai-stack --format svg --output my-stack.svg

# Health check your MCP servers
npx @maiife-ai-pub/mcp-doctor check

# Log an AI interaction
npx @maiife-ai-pub/ai-journal log --tool claude --task coding --duration 30

# Sync AI context across tools
npx @maiife-ai-pub/context-sync push

# Score your AI prompts
npx @maiife-ai-pub/prompt-score analyze --input prompt.txt

# Evaluate agent outputs with rubrics
npx @maiife-ai-pub/eval score --rubric code-review --input review.txt

# Trace agent workflows
npx @maiife-ai-pub/trace list --days 7

# Track AI spend across vendors
npx @maiife-ai-pub/cost report --period last-30d

# Gamified prompt coaching
npx @maiife-ai-pub/prompt-craft score --input prompt.txt

# Audit AI subscriptions for waste
npx @maiife-ai-pub/sub-audit

# Find the best model for your tasks
npx @maiife-ai-pub/model-match recommend --task coding

# Generate your AI week in review
npx @maiife-ai-pub/weekly-ai-report generate

Использование в качестве MCP-сервера

Каждый инструмент с MCP-сервером можно добавить в Claude Desktop, Cursor или любой другой клиент, совместимый с MCP. Каждый из них предоставляет инструменты через транспорт stdio.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) или %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "maiife-probe": {
      "command": "npx",
      "args": ["@maiife-ai-pub/probe", "mcp"]
    },
    "maiife-mcp-audit": {
      "command": "npx",
      "args": ["@maiife-ai-pub/mcp-audit", "mcp"]
    },
    "maiife-mcp-doctor": {
      "command": "npx",
      "args": ["@maiife-ai-pub/mcp-doctor", "mcp"]
    },
    "maiife-eval": {
      "command": "npx",
      "args": ["@maiife-ai-pub/eval", "mcp"]
    },
    "maiife-prompt-score": {
      "command": "npx",
      "args": ["@maiife-ai-pub/prompt-score", "mcp"]
    },
    "maiife-prompt-craft": {
      "command": "npx",
      "args": ["@maiife-ai-pub/prompt-craft", "mcp"]
    },
    "maiife-cost": {
      "command": "npx",
      "args": ["@maiife-ai-pub/cost", "mcp"]
    },
    "maiife-model-match": {
      "command": "npx",
      "args": ["@maiife-ai-pub/model-match", "mcp"]
    },
    "maiife-ai-stack": {
      "command": "npx",
      "args": ["@maiife-ai-pub/ai-stack", "mcp"]
    },
    "maiife-context-sync": {
      "command": "npx",
      "args": ["@maiife-ai-pub/context-sync", "mcp"]
    },
    "maiife-sub-audit": {
      "command": "npx",
      "args": ["@maiife-ai-pub/sub-audit", "mcp"]
    },
    "maiife-trace": {
      "command": "npx",
      "args": ["@maiife-ai-pub/trace", "mcp"]
    }
  }
}

Выберите нужные инструменты — вам не обязательно добавлять их все. После настройки Claude сможет вызывать такие инструменты, как probe_scan, mcp_audit_scan, eval_score, prompt_score_analyze, cost_report и другие прямо из чата.

Запуск с помощью Docker

Каждый MCP-сервер публикуется как Docker-образ в GHCR. Полезно для изолированных сред или интеграции с Glama.

# Pull and run any server
docker run -i ghcr.io/sakthivelchan89/maiife-probe
docker run -i ghcr.io/sakthivelchan89/maiife-mcp-audit
docker run -i ghcr.io/sakthivelchan89/maiife-eval
# ... same pattern for all 12 packages

# Or build from source
docker build -f packages/probe/Dockerfile -t maiife-probe .
docker run -i maiife-probe

Docker-образы используют транспорт stdio (порты не открываются). Передайте -i для интерактивного взаимодействия stdin/stdout с MCP-клиентами.

Качество и соответствие требованиям

Этот набор инструментов нацелен на соответствие стандартам качества MCP Tier 1 (согласно MCP SEP-1730). Вот что это означает:

Параметр	Статус
Лицензия	Apache 2.0 — каноническая SPDX, одобрена OSI
Транспорт	только stdio (без доступа к сети)
CI/CD	GitHub Actions: линтинг + проверка типов + тесты на Node 18, 20, 22
Покрытие тестами	vitest + `@vitest/coverage-v8`, отчет по каждому пакету
Соответствие MCP	Набор тестов на соответствие протоколу для всех 12 MCP-серверов
Сканирование безопасности	CodeQL (еженедельно + при PR), Dependabot (еженедельно)
Реакция на уязвимости	48ч CRITICAL / 7д HIGH (см. DEPENDENCY_POLICY.md)
SLA обработки заявок	2 рабочих дня (см. CONTRIBUTING.md)
Версионирование	SemVer, синхронно по всем пакетам, CHANGELOG.md
Цепочка поставок	`pnpm-lock.yaml` зафиксирован, `--frozen-lockfile` в CI
Безопасность контейнеров	Пользователь без прав root, порты не открыты, подпись GHCR

Набор тестов на соответствие

Каждый MCP-сервер в этом репозитории проверяется на соответствие контракту протокола MCP:

✅ Инвариант транспорта stdio (отсутствие вывода, отличного от JSON, в stdout)
✅ Рукопожатие initialize отвечает валидным serverInfo + возможностями
✅ tools/list возвращает задокументированный набор инструментов
✅ Все поля inputSchema инструментов являются валидными объектами JSON Schema
✅ Вызовы неизвестных инструментов возвращают структурированные ошибки (а не аварийное завершение)

Запуск набора тестов:

pnpm test:conformance      # all packages
cd packages/probe && pnpm test:conformance   # single package

Документация

SECURITY.md — политика сообщения об уязвимостях
CONTRIBUTING.md — рекомендации по внесению правок/PR и SLA
CHANGELOG.md — история версий (формат Keep a Changelog)
DEPENDENCY_POLICY.md — критерии выбора зависимостей и SLA по патчам

Вклад в проект

Вклад приветствуется! Прочитайте CONTRIBUTING.md для получения полного руководства. Краткая версия:

Сделайте форк репозитория на GitHub
Создайте ветку: git checkout -b feat/my-improvement
Внесите изменения — каждый пакет находится в packages/<name>/
Запустите тесты: pnpm test && pnpm test:conformance
Откройте PR в ветку main — опишите, что вы изменили и почему

Пожалуйста, следуйте существующему стилю кода (TypeScript, ESM, Vitest для тестов). Каждый пакет должен работать как CLI и как MCP-сервер, где это применимо.

Лицензия

Apache 2.0 — бесплатно для использования, изменения и распространения.

Часть платформы Maiife — корпоративная панель управления ИИ.

scan_your_ai_toolkit