urlDNA

Máy chủ MCP urlDNA

Blog

urlDNA MCP Server cho phép sử dụng công cụ gốc cho các tác nhân LLM tập trung vào bảo mật như OpenAI GPT-4.1 và Claude Desktop, cung cấp giao diện trực tiếp để tương tác với nền tảng tình báo mối đe dọa urlDNA qua API.

---

Cài đặt & Thiết lập

Dự án này sử dụng uv để quản lý gói Python nhanh chóng.

Điều kiện tiên quyết

Cài đặt uv nếu bạn chưa có:

# 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

Bắt đầu nhanh

1. Sao chép và thiết lập dự án:

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

2. Chạy máy chủ MCP cục bộ (chế độ stdio):

uv run python urldna_mcp/run.py

3. Chạy máy chủ MCP ở chế độ SSE:

uv run python urldna_mcp/server.py

Phát triển

# 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 .

---

Máy chủ MCP được lưu trữ

Máy chủ urlDNA MCP đã được lưu trữ và có sẵn tại:

https://mcp.urldna.io/sse

Máy chủ này có thể truy cập qua giao thức Server-Sent Events (SSE), hỗ trợ tương tác luồng giữa các LLM và các công cụ phụ trợ.

Bạn có thể sử dụng trực tiếp với bất kỳ nền tảng hoặc LLM nào hỗ trợ đặc tả MCP (ví dụ: Claude Desktop, OpenAI GPT-4.1).

---

Các công cụ được hỗ trợ

Quét

Công cụ	Mô tả
fast_check	Kiểm tra ngay lập tức xem một URL đã được quét chưa. Trả về AN TOÀN / ĐỘC HẠI / CHƯA ĐÁNH GIÁ.
new_scan	Gửi một URL để quét toàn bộ và chờ kết quả (~30–60 giây).
get_scan	Lấy kết quả quét đầy đủ theo ID.

Tìm kiếm

Công cụ	Mô tả
search	Tìm kiếm các lần quét bằng CQL (Ngôn ngữ truy vấn tùy chỉnh) trên tên miền, IP, công nghệ, cờ độc hại, v.v. Hỗ trợ phân trang (trang 2+ yêu cầu PREMIUM).

Truy vấn đã lưu

Công cụ	Mô tả
list_queries	Liệt kê tất cả các truy vấn đã lưu cho người dùng đã xác thực.
get_query	Lấy một truy vấn đã lưu cụ thể và các bộ lọc của nó theo ID.
create_query	Tạo một truy vấn đã lưu mới với một hoặc nhiều điều kiện lọc CQL.
update_query	Cập nhật tên và bộ lọc của một truy vấn hiện có (thay thế toàn bộ).
delete_query	Xóa vĩnh viễn một truy vấn đã lưu theo ID.
query_scans	Lấy tất cả các lần quét khớp cho một truy vấn đã lưu.

Giám sát thương hiệu

Công cụ	Mô tả
list_brands	Liệt kê các thương hiệu có sẵn với tùy chọn tìm kiếm theo tên và bộ lọc hiển thị (TẤT CẢ / MIỄN PHÍ / PREMIUM / THƯƠNG HIỆU_NGƯỜI_DÙNG).
get_brand	Lấy chi tiết đầy đủ của một thương hiệu cụ thể theo ID.
brand_scans	Lấy tất cả các lần quét liên quan đến một thương hiệu. Hỗ trợ lọc CQL bổ sung.

Tham khảo API

Công cụ	Mô tả
search_docs	Lấy toàn bộ OpenAPI và tài liệu của urlDNA.

---

Tích hợp với Claude Desktop

Để tích hợp urlDNA MCP server trong Claude Desktop, cập nhật claude_desktop_config.json của bạn:

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

Thay thế <YOUR_PATH> bằng đường dẫn thực tế đến thư mục dự án và <urlDNA_API_KEY> bằng khóa API của bạn từ https://urldna.io.

Sau khi cấu hình, bạn có thể nhắc Claude bằng ngôn ngữ tự nhiên, ví dụ:

"Tìm kiếm trong urlDNA các lần quét độc hại có tiêu đề giống paypal"

"Tạo một truy vấn đã lưu cho các lần quét di động từ Ý bị gắn cờ là độc hại"

"Hiển thị tất cả các lần quét liên quan đến thương hiệu Google"

Claude sẽ tự động gọi đúng công cụ và trả về kết quả từ nền tảng urlDNA.

---

Sử dụng Máy chủ MCP với 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)

---

Triển khai Container

Xây dựng và chạy với 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

---

Đóng góp

1. Fork kho lưu trữ
2. Tạo một nhánh tính năng: git checkout -b feature-name
3. Cài đặt các phụ thuộc phát triển: uv sync --dev
4. Thực hiện các thay đổi của bạn và đảm bảo các bài kiểm tra vượt qua
5. Định dạng mã: uv run black .
6. Gửi một pull request

---

Liên hệ & Hỗ trợ

Để được hỗ trợ hoặc truy cập API, hãy truy cập https://urldna.io hoặc gửi email đến urldna@urldna.io.