urlDNA

urlDNA MCP सर्वर

ब्लॉग

urlDNA MCP Server OpenAI GPT-4.1 और Claude Desktop जैसे सुरक्षा-केंद्रित LLM एजेंटों के लिए मूल उपकरण उपयोग को सक्षम करता है, जो API के माध्यम से urlDNA खतरा खुफिया प्लेटफ़ॉर्म के साथ इंटरैक्ट करने के लिए एक सीधा इंटरफ़ेस प्रदान करता है।

---

स्थापना और सेटअप

यह प्रोजेक्ट तेज़ Python पैकेज प्रबंधन के लिए uv का उपयोग करता है।

पूर्वापेक्षाएँ

यदि आपने पहले से uv स्थापित नहीं किया है तो इसे स्थापित करें:

# 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

त्वरित शुरुआत

1. प्रोजेक्ट को क्लोन और सेटअप करें:

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

2. MCP सर्वर को स्थानीय रूप से चलाएँ (stdio मोड):

uv run python urldna_mcp/run.py

3. MCP सर्वर को SSE मोड में चलाएँ:

uv run python urldna_mcp/server.py

विकास

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

---

होस्टेड MCP सर्वर

urlDNA MCP सर्वर पहले से ही होस्टेड और उपलब्ध है:

https://mcp.urldna.io/sse

यह सर्वर सर्वर-सेंट इवेंट्स (SSE) प्रोटोकॉल के माध्यम से सुलभ है, जो LLM और बैकएंड उपकरणों के बीच स्ट्रीमिंग इंटरैक्शन का समर्थन करता है।

आप इसे सीधे किसी भी प्लेटफ़ॉर्म या LLM के साथ उपयोग कर सकते हैं जो MCP विनिर्देश का समर्थन करता है (जैसे, Claude Desktop, OpenAI GPT-4.1)।

---

समर्थित उपकरण

स्कैनिंग

उपकरण	विवरण
fast_check	तुरंत जाँचें कि क्या कोई URL स्कैन किया गया है। सुरक्षित / दुर्भावनापूर्ण / अनरेटेड लौटाता है।
new_scan	पूर्ण स्कैन के लिए URL सबमिट करें और परिणाम की प्रतीक्षा करें (~30–60 सेकंड)।
get_scan	ID द्वारा पूर्ण स्कैन परिणाम प्राप्त करें।

खोज

उपकरण	विवरण
search	डोमेन, IP, प्रौद्योगिकी, दुर्भावनापूर्ण फ़्लैग और अधिक में CQL (कस्टम क्वेरी भाषा) का उपयोग करके स्कैन खोजें। पृष्ठांकन का समर्थन करता है (पृष्ठ 2+ के लिए PREMIUM आवश्यक है)।

सहेजी गई क्वेरीज़

उपकरण	विवरण
list_queries	प्रमाणित उपयोगकर्ता के लिए सभी सहेजी गई क्वेरीज़ सूचीबद्ध करें।
get_query	ID द्वारा एक विशिष्ट सहेजी गई क्वेरी और उसके फ़िल्टर प्राप्त करें।
create_query	एक या अधिक CQL फ़िल्टर शर्तों के साथ एक नई सहेजी गई क्वेरी बनाएँ।
update_query	किसी मौजूदा क्वेरी का नाम और फ़िल्टर अपडेट करें (पूर्ण प्रतिस्थापन)।
delete_query	ID द्वारा सहेजी गई क्वेरी को स्थायी रूप से हटाएँ।
query_scans	सहेजी गई क्वेरी के लिए सभी मिलान स्कैन प्राप्त करें।

ब्रांड निगरानी

उपकरण	विवरण
list_brands	वैकल्पिक नाम खोज और दृश्यता फ़िल्टर (सभी / मुफ़्त / PREMIUM / USER_BRANDS) के साथ उपलब्ध ब्रांड सूचीबद्ध करें।
get_brand	ID द्वारा किसी विशिष्ट ब्रांड का पूरा विवरण प्राप्त करें।
brand_scans	किसी ब्रांड से जुड़े सभी स्कैन प्राप्त करें। अतिरिक्त CQL फ़िल्टरिंग का समर्थन करता है।

API संदर्भ

उपकरण	विवरण
search_docs	पूर्ण urlDNA OpenAPI और दस्तावेज़ीकरण प्राप्त करें।

---

Claude Desktop के साथ एकीकरण

urlDNA MCP server को Claude Desktop में एकीकृत करने के लिए, अपना claude_desktop_config.json अपडेट करें:

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

<YOUR_PATH> को प्रोजेक्ट निर्देशिका के वास्तविक पथ से और <urlDNA_API_KEY> को https://urldna.io से अपनी API कुंजी से बदलें।

एक बार कॉन्फ़िगर हो जाने पर, आप Claude को प्राकृतिक भाषा में संकेत दे सकते हैं, उदाहरण के लिए:

"urlDNA में paypal जैसे शीर्षक वाले दुर्भावनापूर्ण स्कैन खोजें"

"इटली से मोबाइल स्कैन के लिए एक सहेजी गई क्वेरी बनाएँ जो दुर्भावनापूर्ण के रूप में चिह्नित हैं"

"मुझे Google ब्रांड से जुड़े सभी स्कैन दिखाएँ"

Claude स्वचालित रूप से सही उपकरण को कॉल करेगा और urlDNA प्लेटफ़ॉर्म से परिणाम लौटाएगा।

---

OpenAI GPT-4.1 के साथ MCP सर्वर का उपयोग

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)

---

कंटेनर परिनियोजन

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

---

योगदान

1. रिपॉजिटरी को फोर्क करें
2. एक फीचर शाखा बनाएँ: git checkout -b feature-name
3. विकास निर्भरताएँ स्थापित करें: uv sync --dev
4. अपने परिवर्तन करें और सुनिश्चित करें कि परीक्षण पास हों
5. कोड को प्रारूपित करें: uv run black .
6. एक पुल अनुरोध सबमिट करें

---

संपर्क और समर्थन

समर्थन या API पहुँच के लिए, https://urldna.io पर जाएँ या urldna@urldna.io पर ईमेल करें।