urlDNA MCP Server

resmi

Memindai dan menganalisis URL yang berpotensi berbahaya secara dinamis menggunakan urlDNA.io

Dokumentasi

Server MCP urlDNA

Claude Prompt

urlDNA MCP Server memungkinkan penggunaan alat native untuk agen LLM yang berfokus pada keamanan seperti OpenAI GPT-4.1 dan Claude Desktop, menyediakan antarmuka langsung untuk berinteraksi dengan platform intelijen ancaman urlDNA melalui API.

Instalasi & Pengaturan

Proyek ini menggunakan uv untuk manajemen paket Python yang cepat.

Prasyarat

Instal uv jika Anda belum memilikinya:

# On macOS and Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# On Windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

# Or with pip
pip install uv

Mulai Cepat

Kloning dan atur proyek:

git clone <repository-url>
cd urlDNA-mcp-server
uv sync

Jalankan server MCP secara lokal (mode stdio):

uv run python urldna_mcp/run.py

Jalankan server MCP dalam mode SSE:

uv run python urldna_mcp/server.py

Pengembangan

# Install development dependencies
uv sync --dev

# Run tests (when available)
uv run pytest

# Format code
uv run black .

# Type checking
uv run mypy .

# Lint code
uv run flake8 .

Server MCP Terhosting

Server urlDNA MCP sudah terhosting dan tersedia di:

https://mcp.urldna.io/sse

Server ini dapat diakses melalui protokol Server-Sent Events (SSE), yang mendukung interaksi streaming antara LLM dan alat backend.

Anda dapat menggunakannya langsung dengan platform atau LLM apa pun yang mendukung spesifikasi MCP (misalnya, Claude Desktop, OpenAI GPT-4.1).

Alat yang Didukung

Pemindaian

Alat	Deskripsi
`fast_check`	Periksa secara instan apakah URL telah dipindai. Mengembalikan SAFE / MALICIOUS / UNRATED.
`new_scan`	Kirim URL untuk pemindaian penuh dan tunggu hasilnya (~30–60 detik).
`get_scan`	Ambil hasil pemindaian lengkap berdasarkan ID.

Pencarian

Alat	Deskripsi
`search`	Cari pemindaian menggunakan CQL (Custom Query Language) di seluruh domain, IP, teknologi, flag berbahaya, dan lainnya. Mendukung paginasi (halaman 2+ memerlukan PREMIUM).

Kueri Tersimpan

Alat	Deskripsi
`list_queries`	Daftar semua kueri tersimpan untuk pengguna yang terautentikasi.
`get_query`	Ambil kueri tersimpan tertentu dan filternya berdasarkan ID.
`create_query`	Buat kueri tersimpan baru dengan satu atau lebih kondisi filter CQL.
`update_query`	Perbarui nama dan filter kueri yang ada (penggantian penuh).
`delete_query`	Hapus permanen kueri tersimpan berdasarkan ID.
`query_scans`	Ambil semua pemindaian yang cocok untuk kueri tersimpan.

Pemantauan Merek

Alat	Deskripsi
`list_brands`	Daftar merek yang tersedia dengan pencarian nama opsional dan filter visibilitas (ALL / FREE / PREMIUM / USER_BRANDS).
`get_brand`	Ambil detail lengkap merek tertentu berdasarkan ID.
`brand_scans`	Dapatkan semua pemindaian yang terkait dengan suatu merek. Mendukung filter CQL tambahan.

Referensi API

Alat	Deskripsi
`search_docs`	Ambil OpenAPI urlDNA lengkap dan dokumentasi.

Integrasi dengan Claude Desktop

Untuk mengintegrasikan urlDNA MCP server di Claude Desktop, perbarui claude_desktop_config.json Anda:

{
  "mcpServers": {
    "urlDNA": {
      "command": "uv",
      "args": [
        "--directory",
        "<YOUR_PATH>\\urldna_mcp",
        "run",
        "run.py"
      ],
      "env": {
        "x-api-key": "<urlDNA_API_KEY>"
      }
    }
  }
}

Ganti <YOUR_PATH> dengan jalur aktual ke direktori proyek dan <urlDNA_API_KEY> dengan kunci API Anda dari https://urldna.io.

Setelah dikonfigurasi, Anda dapat memberikan perintah kepada Claude dengan bahasa alami, misalnya:

"Cari di urlDNA untuk pemindaian berbahaya dengan judul seperti paypal"

"Buat kueri tersimpan untuk pemindaian seluler dari Italia yang ditandai sebagai berbahaya"

"Tampilkan semua pemindaian yang terkait dengan merek Google"

Claude akan secara otomatis memanggil alat yang tepat dan mengembalikan hasil dari platform urlDNA.

Menggunakan Server MCP dengan OpenAI GPT-4.1

from openai import OpenAI

# Initialize OpenAI client (assumes OPENAI_API_KEY is set via environment variable)
client = OpenAI()

response = client.responses.create(
    model="gpt-4.1",  # GPT-4.1 supports native MCP tool use
    input=[
        {
            "role": "system",
            "content": [{"type": "input_text", "text": "You are a cybersecurity analyst using urlDNA."}]
        },
        {
            "role": "user",
            "content": [{"type": "input_text", "text": "Search in urlDNA for malicious scans with title like paypal"}]
        }
    ],
    text={"format": {"type": "text"}},
    reasoning={},
    tools=[
        {
            "type": "mcp",
            "server_label": "urlDNA",
            "server_url": "https://mcp.urldna.io/sse",
            "headers": {
                "x-api-key": "<URLDNA_API_KEY>"  # Replace with your urlDNA API key
            },
            "allowed_tools": [
                # --- Scanning ---
                "new_scan",       # Submit a URL for a full scan and wait for the result
                "get_scan",       # Retrieve a scan result by ID
                "fast_check",     # Lightweight instant safety check (SAFE / MALICIOUS / UNRATED)

                # --- Search ---
                "search",         # Search scans using CQL (Custom Query Language)

                # --- Saved Queries (PREMIUM) ---
                "list_queries",
                "get_query",
                "create_query",
                "update_query",
                "delete_query",
                "query_scans",

                # --- Brand Monitoring (PREMIUM) ---
                "list_brands",
                "get_brand",
                "brand_scans",

                # --- API Reference ---
                "search_docs",
            ],
            "require_approval": "never"
        }
    ],
    temperature=0.7,
    top_p=1,
    max_output_tokens=2048,
    store=True
)

print(response.output)

Deployment Kontainer

Bangun dan jalankan dengan Docker:

# Build the container
docker build -t urldna-mcp-server .

# Run the server
docker run -p 8080:8080 -e x-api-key=<URLDNA_API_KEY> urldna-mcp-server

Berkontribusi

Fork repositori
Buat cabang fitur: git checkout -b feature-name
Instal dependensi pengembangan: uv sync --dev
Lakukan perubahan Anda dan pastikan pengujian lulus
Format kode: uv run black .
Kirim pull request

Kontak & Dukungan

Untuk dukungan atau akses API, kunjungi https://urldna.io atau email [email protected].