urldna/mcp

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

7 stars 2 forks 质量 80 趋势 15Apache-2.0

Repository Install

urldna/mcp 是从 https://github.com/urldna/mcp. 导入的 MCP 服务器候选。

概览

urldna/mcp 是从 https://github.com/urldna/mcp. 导入的 MCP 服务器候选。

概述（AI 翻译）

博客

urlDNA MCP Server 支持了以安全为核心的大型语言模型代理（如 OpenAI GPT、Google Gemini 和 Claude Desktop）的原生工具使用，提供了通过 API 与 urlDNA 威胁情报平台直接交互的接口。

该仓库通过两种传输方式暴露相同的工具集：

stdio 用于本地桌面集成，如 Claude Desktop。
streamable-http 用于托管部署，如 Cloud Run。

安装与设置

这个项目使用 UV 进行快速的 Python 包管理。

先决条件

如果你还没安装UV，建议安装：

快速开始

克隆并搭建项目：
本地运行MCP服务器（stdio模式）:
将MCP服务器运行为可流式HTTP模式：

托管服务器读取以下环境变量：

PORT：绑定HTTP端口。默认为8080。
MCP_PATH：公共MCP端点路径。默认为/。

发展

托管MCP服务器

urlDNA MCP 服务器已经托管并可用在：

该服务器可通过可流媒体HTTP访问，适合Cloud Run及其他请求驱动平台。

本页由 AI 翻译，技术细节请以原文为准。

README

以下为原文 README 节选，完整内容请查看原文。

urlDNA MCP Server

Blog

The urlDNA MCP Server enables native tool use for security-focused LLM agents like OpenAI GPT, Google Gemini and Claude Desktop, providing a direct interface to interact with the urlDNA threat intelligence platform via API.

The repository exposes the same toolset over two transports:

stdio for local desktop integrations such as Claude Desktop.
streamable-http for hosted deployments such as Cloud Run.

Installation & Setup

This project uses uv for fast Python package management.

Prerequisites

Install uv if you haven’t already:

# 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

Quick Start

Clone and setup the project:

git clone 
cd urlDNA-mcp-server
uv sync

Run the MCP server locally (stdio mode):

uv run python urldna_mcp/run.py

Run the MCP server in streamable HTTP mode:

uv run python urldna_mcp/server.py

The hosted server reads these environment variables:

PORT: HTTP port to bind to. Defaults to 8080.
MCP_PATH: Public MCP endpoint path. Defaults to /.

Development

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

Hosted MCP Server

The urlDNA MCP server is already hosted and available at:

https://mcp.urldna.io/

This server is accessible over streamable HTTP, which makes it suitable for Cloud Run and other request-driven platforms.

You can use it directly with any platform or LLM that supports the MCP specification (e.g., Claude Desktop, OpenAI GPT, Google Gemini).

Supported Tools

Scanning

Tool	Description
`fast_check`	Instantly check if a URL has been scanned. Returns SAFE / MALICIOUS / UNRATED.
`new_scan`	Submit a URL for a full scan and wait for the result (~30–60s).
`get_scan`	Retrieve a complete scan result by ID.

Search

Tool	Description

在 GitHub 查看完整 README

安装

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

新手？先看 mcpskill.org 教程 →

配置

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