🚀 安全响应工具箱 MCP 服务器
安全响应工具箱 MCP 服务器为安全专业人士量身打造，提供了全面的模型上下文协议（MCP）服务。它集成了丰富的事件响应和网络分析工具，支持诸如 Claude 之类的 AI 代理开展各类网络查询与分析工作，极大地助力了安全调查的高效进行。
🚀 快速开始
安全响应工具箱 MCP 服务器提供了通过模型上下文协议访问的一系列网络和安全工具。它旨在作为通用目的服务，供网络安全事件响应人员使用，使其能够执行基本查找操作，包括：
✓ ASN 查找 ✓ DNS 记录查找（A, AAAA, MX 等） ✓ WHOIS 记录检索 ✓ IP 地理位置服务
✨ 主要特性
1. ASN 查找
- 功能：查询给定 IP 的自治系统编号 (ASN) 和相关详细信息。
- 输入：有效的 IPv4 或 IPv6 地址。
- 输出：包含 ASN、组织名称、注册商和地理位置的 JSON 响应。
2. DNS 记录查找
- 功能：查找指定域名的 DNS 记录（A, AAAA, MX 等）。
- 输入：正确的域名。
- 输出：包含所有相关 DNS 记录类型的详细信息，如 A、AAAA、MX 等。
3. WHOIS 记录检索
- 功能：检索指定域名的 WHOIS 注册信息。
- 输入：正确的域名。
- 输出：包含注册商、registrant、创建日期、到期日期等详细信息的 JSON 响应。
4. IP 地理位置服务
- 功能：根据 IP 地址获取地理位置信息。
- 输入：有效的 IPv4 或 IPv6 地址。
- 输出：包含国家、城市、邮政编码、经纬度和时区等详细信息的 JSON 响应。
🔧 技术细节
错误处理
每个工具遵循一致的错误处理模式：
通用错误响应格式：
{
"状态": "错误",
"错误": "详细错误消息",
"查询": "原始查询值"
}
工具特定错误示例：
- ASN 查找：
{
"ip_addr": "<查询的IP>",
"status": "error",
"error": "无效的 IP 地址格式"
}
- DNS 查找：
{
"domain": "<查询的域名>",
"record_type": "<请求的类型>",
"status": "error",
"error": "DNS 解决失败"
}
- WHOIS 查找：
{
"domain": "<查询的域名>",
"status": "error",
"error": "WHOIS 服务器不可用"
}
- 地理位置：
{
"ip_addr": "<查询的IP>",
"status": "error",
"error": "MaxMind 数据库未找到或许可证密钥无效"
}
项目结构
该项目遵循标准的 Python 包结构：
irtoolshed_mcp_server/ # 主包目录
├── __init__.py # 包初始化
├── asnlookup.py # ASN 查找功能
├── dnslookup.py # DNS 查找功能
├── geolookup.py # 地理位置功能
├── mcp_server.py # 主 MCP 服务器实现
└── whoislookup.py # WHOIS 查找功能
tests/ # 测试目录
├── test_asnlookup.py # ASN 查找测试
├── test_dnslookup.py # DNS 查找测试
├── test_geolookup.py # 地理位置测试
└── test_whoislookup.py # WHOIS 查找测试
📦 安装指南
设置开发环境
- 克隆此仓库：
git clone
cd ir-toolshed-mcp-server
- 创建虚拟环境并安装依赖项：
uv venv
source .venv/bin/activate # 在 Windows 上使用: .venv\Scripts\activate
uv pip install -e ".[dev]"
运行测试
要运行测试套件：
uv run pytest
这将：
- 运行
tests/目录中的所有测试 - 显示测试覆盖率信息
- 显示任何失败的详细输出
⚠️ 重要提示
某些测试需要额外配置：
- 地理位置测试需要 MaxMind GeoLite2 数据库和许可证密钥
- WHOIS 测试可能会失败，如果 WHOIS 服务不可用
代码质量
该项目使用多种工具来维护代码质量：
- 使用 Black 格式化代码：
uv run black .
- 使用 isort 排序导入：
uv run isort .
- 使用 mypy 运行类型检查：
uv run mypy .
- 使用 ruff 运行 linting：
uv run ruff .
📚 详细文档
未来计划
已完成： ✓ ASN 查找 ✓ DNS 记录查找（A, AAAA, MX 等）