MCP Server

🚀 scanmalware - mcp

ScanMalware.comの公開APIをラップする最小限のPython MCPサーバーです。

🚀 クイックスタート

🔍 操作について

デプロイメント、TLS、ロギング、およびDigitalOceanのドロップレットへの接続方法については、docs/OPERATIONS.mdを参照してください。

💻 ローカルでの実行 (Streamable HTTP)

python -m venv .venv
source .venv/bin/activate
pip install -U pip
pip install .

export MCP_TRANSPORT=streamable-http
export MCP_HOST=127.0.0.1
export MCP_PORT=8000

scanmalware-mcp

🐳 Dockerでの実行

docker build -t scanmalware-mcp .
docker run --rm -p 127.0.0.1:8000:8000 \
  -e MCP_TRANSPORT=streamable-http \
  -e MCP_HOST=0.0.0.0 \
  -e MCP_PORT=8000 \
  scanmalware-mcp

オプション: HTTPトランスポートでAuthorization: Bearer <MCP_AUTH_TOKEN>を要求するには、MCP_AUTH_TOKENを設定します。

オプションの認証環境変数 (認証ゲート付きエンドポイントにのみ必要):

• SCANMALWARE_BEARER_TOKEN

その他の環境変数:

• SCANMALWARE_BASE_URL (デフォルト: https://scanmalware.com)
• SCANMALWARE_ALLOW_HTTP (デフォルト: false)
• SCANMALWARE_TIMEOUT_S (デフォルト: 30)
• SCANMALWARE_MAX_DOWNLOAD_BYTES (デフォルト: 10485760)
• SCANMALWARE_ALLOW_PRIVATE_TARGETS (デフォルト: false)
• SCANMALWARE_CA_CERT (オプション; SSLバンプ用のCAバンドルへのパス)

MCPサーバーのセキュリティ環境変数:

• MCP_AUTH_TOKEN (設定されている場合、HTTPトランスポートはAuthorization: Bearer <token>を要求します)
• MCP_RESOURCE_SERVER_URL / MCP_ISSUER_URL (オプション; MCP_AUTH_TOKENが設定されている場合のみ使用)

ツールに関する注意: submit_scanは/api/v1/csrf - tokenを呼び出しません。CSRFトークンツールはありません。 ツールに関する注意: 一部の上流エンドポイントは無効になっており、ツールリストから除外されています (例: get_improvements, find_screenshot_duplicates, get_ai_stats, search_js_fingerprinter2_code_hash, search_js_segments_by_tlsh)。 一部の検索ツールは少なくとも1つのフィルターを必要とし、フィルターが提供されない場合、検証エラーが発生します。

💡 使用例

フィッシングトリアージ (送信 → 待機 → 要約)

Submit a scan for https://example-login-update.com, wait for completion, and
return status, risk_score, and the top indicators. If high risk, include the
AI analysis and screenshot resource.

ブランド乱用監視

Search scans for "acme login" (limit 5). For each result, list scan_id,
status, risk_score, and URL. Highlight anything marked high risk.

TLS/証明書検査

For scan_id 1234...abcd, fetch TLS details and the certificate PEM download.
Summarize issuer, subject, validity dates, and SANs; flag mismatches.

🚀 DigitalOceanへのデプロイ (Debian + Docker + Nginx)

デプロイバンドルはdeploy/にあり、2つのコンテナを実行します:

• mcp (このサーバー、ポート8000でStreamable HTTP)
• nginx (ポート80のフロントエンド; /mcpをMCPサーバーにプロキシ)

前提条件

• doctlが認証済み (doctl auth init)
• SSHキーがDigitalOceanにアップロードされている (doctl compute droplet createで使用)

ドイツ (フランクフルト) に小さなドロップレットを作成する

DROPLET_NAME=scanmalware-mcp-small
REGION=fra1
SIZE=s-1vcpu-2gb
IMAGE=debian-12-x64
SSH_KEYS=$(doctl compute ssh-key list --format ID --no-header | paste -sd, -)

doctl compute droplet create "$DROPLET_NAME" \
  --region "$REGION" \
  --size "$SIZE" \
  --image "$IMAGE" \
  --ssh-keys "$SSH_KEYS" \
  --tag-name scanmalware-mcp \
  --wait

ファイアウォール (パブリックHTTP/HTTPS + SSH)

doctl compute firewall create \
  --name scanmalware-mcp-fw \
  --inbound-rules "protocol:tcp,ports:22,address:0.0.0.0/0,address:::0/0" \
  --inbound-rules "protocol:tcp,ports:80,address:0.0.0.0/0,address:::0/0" \
  --inbound-rules "protocol:tcp,ports:443,address:0.0.0.0/0,address:::0/0" \
  --outbound-rules "protocol:icmp,ports:0,address:0.0.0.0/0,address:::0/0" \
  --outbound-rules "protocol:tcp,ports:0,address:0.0.0.0/0,address:::0/0" \
  --outbound-rules "protocol:udp,ports:0,address:0.0.0.0/0,address:::0/0" \
  --droplet-ids <droplet-id>

ドロップレットにDocker + composeをインストールする

ssh -i /path/to/key root@<droplet-ip> \
  "apt-get update -y && apt-get install -y docker.io docker-compose"

アップロードして実行する

tar --exclude=.git --exclude=.venv --exclude=__pycache__ -czf /tmp/scanmalware-mcp.tar.gz -C . .
scp -i /path/to/key /tmp/scanmalware-mcp.tar.gz root@<droplet-ip>:/tmp/
ssh -i /path/to/key root@<droplet-ip> \
  "mkdir -p /opt/scanmalware-mcp && tar -xzf /tmp/scanmalware-mcp.tar.gz -C /opt/scanmalware-mcp"
ssh -i /path/to/key root@<droplet-ip> \
  "cd /opt/scanmalware-mcp && docker-compose -f deploy/docker-compose.yml up -d --build"

検証する

curl -I https://mcp.scanmalware.com/
curl -I https://mcp.scanmalware.com/mcp

/はNginxから200を返す必要があります。/mcpは、MCP AcceptヘッダーなしのGETで406を返しますが、これは正常な動作です。

スモークテスト (MCP初期化 + ツール/リスト)

python - <<'PY'
import json
import httpx

URL = "http://<droplet-ip>/mcp"
HEADERS = {
    "accept": "application/json, text/event - stream",
    "content - type": "application/json",
}

init_payload = {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
        "protocolVersion": "2025-06-18",
        "capabilities": {},
        "clientInfo": {"name": "mcp - smoke - test", "version": "0.1.0"},
    },
}

with httpx.Client(timeout = 10) as client:
    init_resp = client.post(URL, headers = HEADERS, json = init_payload)
    init_resp.raise_for_status()
    session_id = init_resp.headers.get("mcp - session - id")

    def extract_sse_data(text: str) -> dict:
        for line in text.splitlines():
            if line.startswith("data: "):
                return json.loads(line[len("data: "):])
        raise ValueError("No SSE data line found")

    init_message = extract_sse_data(init_resp.text)
    protocol_version = init_message["result"]["protocolVersion"]

    # Send initialized notification
    client.post(
        URL,
        headers = {
            **HEADERS,
            "mcp - session - id": session_id,
            "mcp - protocol - version": protocol_version,
        },
        json = {"jsonrpc": "2.0", "method": "notifications/initialized"},
    )

    tools_resp = client.post(
        URL,
        headers = {
            **HEADERS,
            "mcp - session - id": session_id,
            "mcp - protocol - version": protocol_version,
        },
        json = {"jsonrpc": "2.0", "id": 2, "method": "tools/list"},
    )
    tools_resp.raise_for_status()
    tools_message = extract_sse_data(tools_resp.text)
    tool_names = [tool["name"] for tool in tools_message["result"]["tools"]]

print("protocol_version:", protocol_version)
print("tool_count:", len(tool_names))
print("tools:", ", ".join(tool_names))
PY

再デプロイ / 新しいデプロイ

2つの一般的なフロー:

1. 同じドロップレットでのインプレース更新

tar --exclude=.git --exclude=.venv --exclude=__pycache__ -czf /tmp/scanmalware-mcp.tar.gz -C . .
scp -i /path/to/key /tmp/scanmalware-mcp.tar.gz root@<droplet-ip>:/tmp/
ssh -i /path/to/key root@<droplet-ip> \
  "bash /opt/scanmalware-mcp/deploy/redeploy.sh /tmp/scanmalware-mcp.tar.gz"

再デプロイスクリプトは、ファイルを交換する前にコンテナを停止して、バインドマウントのinode問題を回避します。 スクリプトがまだドロップレットにない場合は、一度レガシーのtar + docker - composeコマンドを実行してインストールしてください。

リポジトリのルートからのオプションのワンショットヘルパー:

./deploy/push-redeploy.sh root@<droplet-ip> /path/to/key

2. ローリングデプロイ (新しいドロップレット)

• 新しいドロップレットを作成する (上記の手順)
• 同じバンドルをデプロイする
• DNSを新しいIPに切り替える
• 準備ができたら古いドロップレットを破棄する

doctl compute droplet delete <old-droplet-id> --force