urldna/mcp

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

7 stars 2 forks 品質 80 トレンド 15Apache-2.0

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

概要

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

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

MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

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