F6 ASM MCP Server

English

MCP-сервер для клиентского API F6 ASM (Attack Surface Management). Через него ИИ-ассистент получает доступ к внешнему периметру компании: активам (домены, IP, диапазоны, сертификаты, ПО) и найденным на них проблемам. Можно получать сами записи с фильтрами или сводные цифры.

Тулы

Все тулы только читают данные. Эндпоинты, которые что-то создают, меняют, удаляют или переводят статус, asm_request отклоняет ещё до отправки запроса.

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

Понадобятся uv (или Python 3.10+ и pip), адрес вашей инсталляции ASM и API-токен. uvx asm-mcp скачивает пакет с PyPI и запускает его в отдельном окружении, ставить ничего заранее не нужно.

{
  "mcpServers": {
    "asm": {
      "command": "uvx",
      "args": ["asm-mcp"],
      "env": {
        "ASM_BASE_URL": "https://asm.example.com",
        "ASM_API_TOKEN": "<token>"
      }
    }
  }
}

Этот блок подходит для Claude Desktop и Cursor. Для VS Code используется файл .vscode/mcp.json: ключ servers и "type": "stdio", остальное так же.

Для Claude Code:

claude mcp add asm \
  -e ASM_BASE_URL=https://asm.example.com -e ASM_API_TOKEN=<token> \
  -- uvx asm-mcp

Вместо uvx можно поставить пакет командой pip install asm-mcp и указать клиенту команду asm-mcp.

Установка из исходников в отдельное окружение:

cd asm-mcp
python3 -m venv venv
./venv/bin/pip install --require-hashes -r requirements.lock
./venv/bin/pip install --no-deps -e .

После этого укажите клиенту "command": "/path/to/asm-mcp/venv/bin/asm-mcp" без args. На Windows путь будет venv\Scripts\asm-mcp.exe.

Можно запускать в контейнере:

docker build -t asm-mcp .
docker run -i --rm -e ASM_BASE_URL -e ASM_API_TOKEN asm-mcp

Первым вызовом сделайте asm_list_companies. Он показывает, что адрес, токен и доступ к компаниям в порядке.

Переменные окружения

Выключить проверку TLS нельзя: такой настройки нет намеренно. Для внутреннего УЦ используйте ASM_CA_BUNDLE.

Примеры

asm_list_companies
asm_issues_summary  company_id="…"
asm_get_issues      company_id="…" severity=["crit"] status=["detected"] fields=["alertBody.asset","testName","alertBody.reason"]
asm_get_assets      company_id="…" type=["domain","ip"] status=["confirmed","new"]
asm_get_assets      company_id="…" seq_update="1700000000000_0a1b…"
asm_request         path="reports/<company_id>/last"
asm_request         method="POST" path="dashboard/scores" params={"companyId":"…","dateFrom":"2026-10-01"}

Периметр компании — это активы со статусом confirmed или new. Статус false означает, что актив исключён. Открытые проблемы — это статусы detected и under review.

Пагинация

asm_get_assets и asm_get_issues идут от старых записей к новым и сами перелистывают страницы. Один вызов останавливается в одном из трёх случаев: набрано max_items записей, истёк ASM_TOOL_BUDGET или ответ дошёл до 1 МБ. Тогда в ответе будет complete: false, причина в reason и курсор в seqUpdate. Курсор — это seqUpdate последней отданной записи, поэтому при продолжении записи не пропускаются. Если сохранить seqUpdate после полного обхода, следующий вызов с ним вернёт только изменения.

Сводки по большим компаниям

Компанию на 10 000+ активов при лимите 1 запрос/с за один вызов не обойти. Сводка считает, пока хватает ASM_TOOL_BUDGET, а затем передаёт посчитанное и курсор фоновой задаче в процессе сервера. Ответ приходит с complete: false и job_id. Повторный вызов с теми же аргументами возвращает прогресс, а после завершения полный результат. Задачи хранятся только в памяти, файлы не пишутся. Одновременно идут не больше двух задач.

Обход особенностей API

• Фильтр status в /issues/updated пропускает записи с другими статусами. Статус и severity перепроверяются на клиенте, а число отброшенных записей возвращается в droppedByFilter.
• Если задан фильтр и count маленький, API отвечает пустой страницей. Поэтому при фильтрах count не бывает меньше 100, а лишнее обрезается на клиенте.
• Тяжёлые страницы доменов не успевают загрузиться. В этом случае страница запрашивается заново в половину размера, но не меньше 50.
• Соответствие severity: crit/high/medium/low = alertSeverity Crit/Error/Warning/Low = alertBody.status Critical/High/Medium/Low severity.
• Тест CVE называется CVE vulnurability (именно так, с опечаткой).

Безопасность

Всё, что возвращают тулы, попадает в контекст языковой модели: периметр компании, уязвимости, а через issues/leaks ещё и утёкшие учётные данные. Выбирайте провайдера модели с учётом этого. Выдавайте серверу токен с доступом только к нужным компаниям.

Токен отправляется только на адрес из ASM_BASE_URL и только по https://. Редиректы не выполняются. Ответ больше 1 МБ не передаётся модели.

Модель угроз описана в SECURITY.md.

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

См. CONTRIBUTING.md.

Лицензия

Apache License 2.0