Skip to main content
Glama
kalala252

asm-mcp-server

by kalala252

asm-mcp-server

asm-agentをMCPクライアントから利用するためのローカルサーバーです。接続したLLMは、公開情報の収集、保存済み結果の参照、根拠の確認をMCPツールとして実行できます。

このサーバー自体はLLM APIを呼びません。会話と要約には、MCPクライアント側のモデルを使用します。

必要なもの

  • Python 3.12以上

  • uv

  • 別途セットアップしたasm-agent

  • MCPに対応したLLMクライアント

Related MCP server: groundwork

セットアップ

asm-agentasm-mcp-serverを別フォルダに配置し、それぞれ依存関係を準備します。

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

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

Shodanを使う場合は、asm-agent側でAPIキーを保存します。

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ではcommanduv.exeの絶対パスを指定し、ASM_AGENT_EXECUTABLEには次の形式で指定します。

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

会話例

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

利用できるツール

ツール

内容

scan_domain

ドメインの公開情報を収集して保存します

list_reports

保存済みレポートの一覧を返します

get_report_summary

収集件数、警告、エラーを返します

list_assets

ホスト名、IPアドレス、公開サービスを返します

get_evidence

情報源と観測日時を返します

list_vulnerabilities

ShodanのCVE候補、製品、バージョンを返します

一覧を返すツールはoffsetlimitで分割取得できます。

設定

環境変数

既定値

内容

ASM_AGENT_EXECUTABLE

PATH上のasm-agent

実行するasm-agentの絶対パス

ASM_MCP_REPORT_DIR

./reports

レポート保存先

ASM_MCP_SCAN_TIMEOUT_SECONDS

600

1回の調査を待つ最大秒数

ShodanのCVEは過去の観測に基づく候補であり、現在も脆弱であることを証明するものではありません。

開発

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

ライセンス

MIT License

A
license - permissive license
Not graded
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    A
    quality
    C
    maintenance
    Provides AI agents with 37 OSINT tools and 12 data sources to perform unified reconnaissance, domain analysis, and attack surface mapping. It enables agents to query, correlate, and reason across platforms like Shodan, VirusTotal, and Censys in parallel.
    37
    681
    44
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables AI agents to perform grounded web research with injection resistance, claim verification, and cost-aware routing through MCP tools like web_search, fetch_url, extract_claims, and check_grounding.
    MIT
  • A
    license
    B
    quality
    A
    maintenance
    MCP search and evidence tool for AI agents. Rewrites queries, zooms into source domains, and returns sourced answers with metrics.
    1
    1
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables LLMs to perform OSINT link-analysis by exposing transforms (DNS, WHOIS, Shodan, etc.) as MCP tools for autonomous investigation and graph enrichment.
    MIT

View all related MCP servers

Related MCP Connectors

  • Web research for agents: quality-scored Google search, webpage extraction, and deep research.

  • Hosted MCP with 91 agent tools: X, domains, SEO, Maps, Trends, Search, YouTube, TikTok, and more.

  • AI research on companies and industries — one MCP tool per research domain.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/kalala252/asm-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server