MCP Threathunting

威胁追踪MCP服务器

一个模型上下文协议（MCP）服务器，为AI代理提供威胁情报查找，并可选一个Python服务器来解析HTML。

Watch Minimal Example

当前供应商：

• VirusTotal（IP，域）
• 滥用IPDB（IP）
• URL扫描（URL）

该项目正在积极开发中，主要用于个人使用。

需求

• Node.js 18+
• 打字稿
• VirusTotal API密钥
• 滥用IPDB API密钥
• UrlScan API密钥
• 紫外线

安装

git clone https://github.com/DiegoInFinland/mcp-threathunting.git
cd mcp-threathunting
npm install -y
# optional for Python server.
chmod +x setup-web-parser.sh && ./setup-web-parser.sh

配置

创建一个 .env 项目根目录中的文件，其中包含：

VT_KEY=your_virustotal_api_key
VT_URL_IP=https://www.virustotal.com/api/v3/ip_addresses/
VT_URL_DOMAIN=https://www.virustotal.com/api/v3/domains/
VT_URL_FILE=https://www.virustotal.com/api/v3/files/
VT_URL_URL=https://www.virustotal.com/api/v3/urls/

ABUSEIPDB_KEY=your_abuseipdb_api_key
ABUSEIPDB_CHECK=https://api.abuseipdb.com/api/v2/check
ABUSEIPDB_REPORT=https://api.abuseipdb.com/api/v2/reports

URLSCAN_KEY=your_urlsscan_api_key
URLSCAN=https://urlscan.io/api/v1/scan
URLSCAN_RESULT=https://urlscan.io/api/v1/result
URLSCAN_SCREENSHOT=https://urlscan.io/screenshots

笔记：

• 您必须在.env文件和Claude Code配置文件中添加API密钥才能使用服务。

在本地运行

npx -y tsx src/server.ts

使用MCP检查器进行调试

npx @modelcontextprotocol/inspector -- npx -y tsx src/server.ts

VirusTotal API的Claude Desktop配置示例

{
  "mcpServers": {
    "threat-hunting": {
      "command": "npx",
      "args": [
        "-y",
        "--silent",
        "tsx",
        "/path/to/your/mcp-threathunting/src/server.ts"
      ],
      "env": {
        "VT_KEY": "your_vt_key",
        "VT_URL_IP": "https://www.virustotal.com/api/v3/ip_addresses/",
        "VT_URL_URL": "https://www.virustotal.com/api/v3/urls/",
        "VT_URL_DOMAIN": "https://www.virustotal.com/api/v3/domains/"
      }
    }
  }
}

已知限制

• JSON响应目前已完整返回。
• 有限的重试/超时/速率限制处理。
• 尚未完全实施测试。
• 这仍然是一个不断发展的爱好项目。