asm-mcp-server

Dies ist ein lokaler Server zur Nutzung von asm-agent über einen MCP-Client. Ein verbundenes LLM kann das Sammeln öffentlicher Informationen, das Abrufen gespeicherter Ergebnisse und die Überprüfung von Belegen als MCP-Tools ausführen.

Dieser Server selbst ruft keine LLM-API auf. Für Konversation und Zusammenfassung wird das Modell des MCP-Clients verwendet.

Voraussetzungen

• Python 3.12 oder höher

• uv

• Ein separat eingerichtetes asm-agent

• Ein LLM-Client mit MCP-Unterstützung

Related MCP server: groundwork

Einrichtung

Platzieren Sie asm-agent und asm-mcp-server in separaten Ordnern und bereiten Sie jeweils die Abhängigkeiten vor.

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

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

Wenn Sie Shodan verwenden, speichern Sie den API-Schlüssel auf der asm-agent-Seite.

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

Beim MCP-Client registrieren

Fügen Sie der Konfiguration des MCP-Clients Folgendes hinzu. Geben Sie alles als absolute Pfade an.

{
  "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"
      }
    }
  }
}

Starten Sie den MCP-Client nach der Registrierung neu oder verbinden Sie ihn erneut.

Unter Windows geben Sie den absoluten Pfad zu uv.exe als command an und ASM_AGENT_EXECUTABLE im folgenden Format:

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

Beispiel für eine Konversation

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

Verfügbare Tools

Tools, die eine Liste zurückgeben, können mit offset und limit in Teilen abgerufen werden.

Konfiguration

Shodan-CVEs sind Kandidaten auf Grundlage früherer Beobachtungen und beweisen nicht, dass eine Schwachstelle derzeit noch besteht.

Entwicklung

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

Lizenz

MIT License