MCP

🚀 urlDNA MCP Server

urlDNA MCP Server 為專注於安全的大語言模型（LLM）代理（如 OpenAI GPT - 4.1 和 Claude 3 Desktop）提供原生工具使用能力，通過 API 提供與 urlDNA 威脅情報平臺直接交互的接口。

博客

🚀 快速開始

urlDNA MCP 服務器已託管並可通過以下地址訪問：

https://mcp.urldna.io/sse

該服務器通過服務器發送事件（SSE） 協議訪問，支持大語言模型與後端工具之間的流式交互。你可以直接在任何支持 mcp 規範的平臺或大語言模型（如 Claude Desktop、OpenAI GPT - 4.1）中使用它。

✨ 主要特性

MCP 接口提供了以下工具：

📦 安裝指南

環境要求

• Python 3.9+

安裝依賴

pip install -r requirements.txt

💻 使用示例

與 Claude Desktop（Anthropic MCP）集成

要在 Claude Desktop 中集成 urlDNA MCP server，請按如下方式更新你的 Claude 配置（通常是 claude.config.json 或等效文件）：

{
  "mcpServers": {
    "urlDNA": {
      "command": "python",
      "args": [
        "<YOUR_PATH>/run.py"
      ],
      "env": {
        "authorization": "<urlDNA_API_KEY>"
      }
    }
  }
}

⚠️ 重要提示

請將 <YOUR_PATH> 替換為 run.py 的實際路徑，並將 <urlDNA_API_KEY> 替換為你從 https://urldna.io 獲取的 API 密鑰。

配置完成後，你可以用自然語言向 Claude 發出請求，例如：

“在 urlDNA 中搜索標題類似 paypal 的惡意掃描”

Claude 將自動調用正確的工具並返回 urlDNA 平臺的結果。

與 OpenAI GPT - 4.1（Python SDK）配合使用

from openai import OpenAI

# Initialize OpenAI client (assumes API key is set via env var or config)
client = OpenAI()

response = client.responses.create(
    model="gpt-4.1",
    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 malicious scan with title like paypal"}]
        }
    ],
    text={"format": {"type": "text"}},
    reasoning={},
    tools=[
        {
            "type": "mcp",
            "server_label": "urlDNA",
            "server_url": "https://mcp.urldna.io/sse",
            "headers": {
                "Authorization": "Bearer <URLDNA_API_KEY>"
            },
            "allowed_tools": ["new_scan", "get_scan", "search", "fast_check"],
            "require_approval": "never"
        }
    ],
    temperature=0.7,
    top_p=1,
    max_output_tokens=2048,
    store=True
)

print(response.output)

📄 聯繫與支持

如需支持或獲取 API 訪問權限，請訪問 https://urldna.io 或發送電子郵件至 urldna@urldna.io。