asm-mcp-server

Это локальный сервер для использования asm-agent из MCP-клиента. Подключённая LLM может выполнять сбор публичной информации, просмотр сохранённых результатов и проверку обоснований в виде MCP-инструментов.

Сам сервер не вызывает LLM API. Для разговора и обобщения используется модель на стороне MCP-клиента.

Требования

• Python 3.12 или новее

• uv

• Отдельно настроенный asm-agent

• LLM-клиент с поддержкой MCP

Related MCP server: groundwork

Настройка

Разместите asm-agent и asm-mcp-server в отдельных папках и подготовьте зависимости для каждого.

cd /absolute/path/to/asm-agent
uv sync

cd /absolute/path/to/asm-mcp-server
uv sync

Если вы используете Shodan, сохраните API-ключ на стороне asm-agent.

cd /absolute/path/to/asm-agent
uv run asm-agent credentials set-shodan

Регистрация в MCP-клиенте

Добавьте следующее содержимое в настройки MCP-клиента. Указывайте всё абсолютными путями.

{
  "mcpServers": {
    "passive-attack-surface": {
      "command": "/absolute/path/to/uv",
      "args": [
        "--directory",
        "/absolute/path/to/asm-mcp-server",
        "run",
        "asm-mcp-server"
      ],
      "env": {
        "ASM_AGENT_EXECUTABLE": "/absolute/path/to/asm-agent/.venv/bin/asm-agent",
        "ASM_MCP_REPORT_DIR": "/absolute/path/to/asm-mcp-server/reports"
      }
    }
  }
}

После регистрации перезапустите или переподключите MCP-клиент.

В Windows укажите абсолютный путь к uv.exe в command, а ASM_AGENT_EXECUTABLE — в следующем формате:

C:\absolute\path\to\asm-agent\.venv\Scripts\asm-agent.exe

Пример разговора

example.comをShodanありで調査して、見つかったホスト名、IPアドレス、公開ポート、CVE候補を根拠付きでまとめて。

Доступные инструменты

Инструменты, возвращающие списки, поддерживают постраничное получение с помощью offset и limit.

Конфигурация

CVE из Shodan — это кандидаты, основанные на прошлых наблюдениях, и они не доказывают, что система уязвима в настоящее время.

Разработка

uv run ruff check .
uv run mypy src
uv run pytest

Лицензия

MIT License