🚀 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 接口提供了以下工具：
| 工具 | 描述 |
|---|---|
new_scan |
为给定的 URL 提交新的扫描 |
get_scan |
通过 ID 检索扫描结果 |
search |
使用文本、域名或过滤器搜索扫描结果 |
fast_check |
通过内容 + 重定向分析进行轻量级网络钓鱼检测 |
📦 安装指南
环境要求
- 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": [
"/run.py"
],
"env": {
"authorization": ""
}
}
}
}
⚠️ 重要提示
请将
替换为run.py的实际路径，并将替换为你从 https://urldna.io 获取的 API 密钥。
配置完成后，你可以用自然语言向 Claude 发出请求，例如：
"Search in urlDNA for malicious scans with title like paypal"
Claude 将自动调用正确的工具，并返回 urlDNA 平台的结果。
使用 MCP Server 与 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 "
},
"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。