secretscan-mcp-server

Сервер MCP, который сканирует diff, содержимое файла или вставленный фрагмент на предмет случайно закоммиченных секретов, — чтобы любой совместимый с MCP агент мог самостоятельно проверить свои изменения перед коммитом, открытием PR или вставкой фрагмента лога куда-либо. Полностью локальный: без API-ключа, без сетевых вызовов, без зависимостей, кроме MCP SDK и Zod.

Зачем

Утечка учётных данных — одна из самых частых реальных причин компрометации аккаунтов и инфраструктуры, а также одна из самых лёгких ошибок в большом diff: отладочный console.log с настоящим API-ключом, случайно закоммиченный конфигурационный файл, .env, вставленный в чат при обращении за помощью. Агент, который собирается коммитить, пушить или делиться текстом, хорошо подходит для того, чтобы поймать это до того, как оно произойдёт, если у него есть дешёвый способ проверки.

Related MCP server: opzyai

Инструмент

scan_for_secrets

Сканирует текст на наличие совпадений с фиксированным набором сигнатур форматов провайдеров, а также применяет универсальную эвристику с порогом энтропии:

Найденные секреты всегда маскируются — AKIAIOSFODNN7EXAMPLE выводится как AKIA************MPLE (20 chars), никогда в полном виде. Поэтому вывод самого инструмента можно безопасно логировать или показывать, не распространяя найденное дальше.

Это сканирование по фиксированным шаблонам + эвристике, а не исчерпывающий поиск. Чистый результат означает «не совпал ни один известный шаблон», а не «точно безопасно» — об этом явно говорится в выводе приложения.

Установка и настройка

git clone https://github.com/wedo911/secretscan-mcp-server.git
cd secretscan-mcp-server
npm install
npm run build

Добавьте его в конфигурацию вашего MCP-клиента (например, claude_desktop_config.json или .mcp.json проекта для Claude Code):

{
  "mcpServers": {
    "secretscan": {
      "command": "node",
      "args": ["/absolute/path/to/secretscan-mcp-server/dist/index.js"]
    }
  }
}

Запуск тестов

npm run build
node --test tests/entropy.test.mjs tests/detectors.test.mjs

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

Попробуйте без клиента

npx @modelcontextprotocol/inspector --cli node dist/index.js \
  --method tools/call --tool-name scan_for_secrets \
  --tool-arg text='aws_access_key_id = AKIAIOSFODNN7EXAMPLE'

(Это собственный публично задокументированный пример ключа AWS — не настоящие учётные данные.)

Лицензия

MIT — см. LICENSE.