asm-mcp-server

Es un servidor local para utilizar asm-agent desde un cliente MCP. El LLM conectado puede ejecutar como herramientas MCP la recopilación de información pública, la consulta de resultados guardados y la verificación de evidencias.

Este servidor en sí no llama a la API de LLM. Para la conversación y el resumen se utiliza el modelo del lado del cliente MCP.

Requisitos

• Python 3.12 o superior

• uv

• asm-agent configurado por separado

• Un cliente LLM compatible con MCP

Related MCP server: groundwork

Configuración

Coloque asm-agent y asm-mcp-server en carpetas separadas y prepare las dependencias de cada uno.

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

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

Si utiliza Shodan, guarde la clave de API en el lado de asm-agent.

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

Registro en el cliente MCP

Añada el siguiente contenido a la configuración del cliente MCP. Especifique todas las rutas como rutas absolutas.

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

Después del registro, reinicie o vuelva a conectar el cliente MCP.

En Windows, especifique la ruta absoluta de uv.exe en command y especifique ASM_AGENT_EXECUTABLE con el siguiente formato.

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

Ejemplo de conversación

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

Herramientas disponibles

Las herramientas que devuelven listas pueden recuperar resultados por partes con offset y limit.

Configuración

Los CVE de Shodan son candidatos basados en observaciones pasadas y no demuestran que el sistema siga siendo vulnerable en la actualidad.

Desarrollo

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

Licencia

MIT License