Arvind29/threat-intel-mcp-server
GitHub: Arvind29/threat-intel-mcp-server
基于 Python 的 MCP 服务器,为 AI 助手集成 VirusTotal 和 AbuseIPDB 的 IP 信誉查询能力。
Stars: 0 | Forks: 0
# 威胁情报 MCP Server
一个基于 Python 的 Model Context Protocol (MCP) server,为 Claude Desktop 等 AI 助手提供威胁情报工具。
该项目演示了如何构建一个自定义的 MCP server,并集成以下平台:
- VirusTotal
- AbuseIPDB
该服务器提供了可供 AI 调用的工具,用于从多个威胁情报提供商获取 IP 信誉数据。
## 功能
- 使用官方 Python MCP SDK 构建的 MCP Server
- IP 信誉查询
- VirusTotal 集成
- AbuseIPDB 集成
- 适用于 AI agent 的 JSON 响应
- 兼容 Claude Desktop(本地 MCP)
## 架构
```
User
│
▼
Claude Desktop
(MCP Client)
│
▼
Threat Intelligence MCP Server
│
┌─────────────┴─────────────┐
▼ ▼
VirusTotal API AbuseIPDB API
│ │
└─────────────┬─────────────┘
▼
Combined Reputation
│
▼
Claude Response
```
## 技术
- Python 3.14+
- Model Context Protocol (MCP)
- Requests
- VirusTotal REST API
- AbuseIPDB REST API
## 安装说明
克隆仓库
```
git clone https://github.com//threat-intel-mcp.git
cd threat-intel-mcp
```
安装依赖
```
pip install "mcp[cli]" requests
```
## 配置
编辑 `server.py`
将以下内容:
```
VT_API_KEY = "YOUR_VIRUSTOTAL_API_KEY"
ABUSE_API_KEY = "YOUR_ABUSEIPDB_API_KEY"
```
替换为您自己的 API 密钥。
## 运行 Server
```
python server.py
```
启动 MCP Inspector
```
mcp dev server.py
```
## Claude Desktop 配置
示例配置
```
{
"mcpServers": {
"ThreatIntel": {
"command": "python",
"args": [
"C:\\path\\to\\server.py"
]
}
}
}
```
更新配置后请重启 Claude Desktop。
## 可用工具
### lookup_ip_reputation(ip)
检查 IP 地址是否存在于以下平台:
- VirusTotal
- AbuseIPDB
示例:
```
Check IP 8.8.8.8
```
示例响应
```
{
"ip":"8.8.8.8",
"virustotal":{
"malicious":0,
"suspicious":0
},
"abuseipdb":{
"abuseConfidenceScore":0
}
}
```
## 项目结构
```
.
├── server.py
├── README.md
└── requirements.txt
```
## 学习目标
本项目演示了:
- 构建自定义 MCP Server
- 使用 FastMCP 创建 AI 工具
- 集成外部 REST API
- 向 AI 客户端返回结构化的 JSON 数据
- 将本地 MCP server 连接到 Claude Desktop
## 参考资料
- Model Context Protocol
- VirusTotal API
- AbuseIPDB API
## 许可证
MIT License
## 免责声明
本项目旨在用于教育目的,演示了如何将外部威胁情报 API 与 Model Context Protocol (MCP) 集成。API 的使用受限于 VirusTotal 和 AbuseIPDB 的服务条款和速率限制。
标签:Claude, CVE检测, IP信誉查询, MCP, Python, 人工智能, 威胁情报, 字符串匹配, 实时处理, 开发者工具, 无后门, 用户模式Hook绕过, 逆向工具