shipcheck-mcp

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

Работает с Claude Code, OpenCode, Cursor или любым MCP-совместимым агентом — это стандартный сервер Model Context Protocol, а не инструмент только для Claude.

ИИ-агенты для написания кода спокойно выпускают приложения, которые сливают API-ключи, подтягивают пакеты под лицензией GPL, оставляют админ-маршруты открытыми в интернет, собирают email-адреса без политики конфиденциальности или работают с сырыми номерами карт, — потому что «оно запускается» и «это можно выпускать» — разные вопросы, а ваш агент отвечает только на первый.

ShipCheck отвечает на второй. Он запускает пять быстрых детерминированных проверок по вашему проекту и объясняет каждую находку простыми словами — что не так, почему это важно для вас и как именно это исправить. Опыт в безопасности не нужен.

Честный по замыслу: ShipCheck отмечает рискованные паттерны. Это не юридическая проверка и не гарантия. Чистое сканирование означает, что ничего не совпало с этими конкретными проверками, — и ничего больше. Полный список нецелей см. в PRD.md §2.

Два инструмента, два момента

Встроенный навык вырабатывает у агента привычку: scan_diff перед коммитами, scan_repo перед запуском.

Related MCP server: agentguard

Работает с вашим стеком

Каждая сводка сообщает, какие стеки были обнаружены (project_types), и честно предупреждает, когда обнаруженный стек покрыт не полностью (coverage_caveat), а не намекает, что всё в порядке.

Как выглядит находка

[critical] lib/firebase_options.dart — Возможный ключ Google API в коде, работающем на устройствах пользователей.

Почему это важно: Этот ключ распространяется внутри вашего приложения и доходит до телефона или браузера каждого пользователя. Любой может скопировать его и использовать от вашего имени — тратя ваши деньги или читая ваши данные.

Как исправить: Перенесите ключ в отдельный файл секретов, который никогда не становится частью проекта, загружайте его при запуске, затем получите новый ключ из панели управления провайдера — считайте этот ключ скомпрометированным.

Старт за 30 секунд

# In Claude Code:
/plugin marketplace add noureldeensalama/shipcheck
/plugin install shipcheck

# Then just talk to your agent:

"запусти shipcheck перед коммитом" · "это готово к запуску?" · "просканируй этот репозиторий"

Без интерфейса / CI:

claude --plugin-dir /path/to/shipcheck -p "Run shipcheck scan_repo on . and summarize findings"

Автономный MCP-сервер (Cursor, OpenCode и что угодно ещё)

git clone https://github.com/noureldeensalama/shipcheck.git
cd shipcheck && npm install && npm run build

{
  "mcpServers": {
    "shipcheck": { "command": "node", "args": ["/absolute/path/to/shipcheck/dist/index.js"] }
  }
}

Или после публикации: npx shipcheck-mcp

Создан, чтобы ему доверяли

• Детерминированность: только regex и метаданные зависимостей. LLM объясняет находки уже после; она никогда не решает, существует ли находка (PRD.md §4).

• Тихий по замыслу: одинаковые ключи дедуплицируются в одну находку со всеми местами; вывод упорядочен по серьёзности, компактный (~1k токенов в репозитории на 100k строк кода), ограничен 100 находками с явным флагом усечения; вендорные деревья (node_modules, .venv, build…) никогда не сканируются; значения-заглушки (mock…, CI-заглушки) и публичные по замыслу конфиги (google-services.json, firebase_options.dart) не поднимают ложную тревогу.

• Проверено на реальном коде: обкатано на пяти продакшн-репозиториях — обнаружен действующий ключ Supabase service-role в 13 файлах и три неаутентифицированных debug-эндпоинта; затем подтверждено, что исправления внесены, и отмечен второй ключ, сохранившийся только в истории git. Полный журнал истинных и ложных срабатываний: DOGFOOD_RESULTS.md.

Совместимость

Как проверить самостоятельно

npm test             # 53 unit tests
npm run e2e          # 21 real-MCP-protocol checks
npm run verify-fixture   # acceptance gate over deliberately-vulnerable fixtures
npm run dogfood -- /path/to/any/repo   # scan any repo from the CLI

Участие в разработке

Приветствуются issues и PR — см. CONTRIBUTING.md. Новые категории детекторов требуют и фикстуру, которая срабатывает на риск, и регрессионный тест без избыточных срабатываний; особенно ценны отчёты о ложных срабатываниях с примерами реального кода. Результаты по реальным репозиториям — в DOGFOOD_RESULTS.md.

Лицензия

MIT — см. LICENSE.