Sec MCP

sec-mcp是一个Python安全检测工具包，提供域名、URL、IP等的安全检查功能，支持Python应用集成、终端CLI使用或作为MCP服务器运行，为LLM提供实时威胁洞察。

安全人工智能聊天机器人 #安全检测 #黑名单检查 #实时威胁 #LLM集成 .Python

评分 : 2分

下载量 : 6.9K

更新时间 : 2025-04-29

打开站点

sec-mcp - 安全上下文信息查询协议工具

安装指南

使用示例

URL安全检查

批量处理文件

自定义规则应用

常见问题解答

如何更新黑名单数据库？

支持哪些数据源？

如何查看当前版本？

🚀 sec-mcp 使用说明

sec-mcp 是由 Montimage 公司开发的一款用于网络安全监控和威胁检测的工具。它具备多种实用功能，如管理黑名单数据库、批量检查网址或 IP 地址的安全性，还能通过 API 或 MCP 服务器集成到 AI 驱动的客户端中，为网络安全保驾护航。

🚀 快速开始

安装步骤

创建虚拟环境

创建虚拟环境：
```
python3.12 -m venv .venv
```

激活虚拟环境：

source .venv/bin/activate  # 对于 macOS/Linux
或者
.venv\Scripts\activate  # 对于 Windows

安装 sec-mcp：
```
pip install sec-mcp
```

✨ 主要特性

新增功能 - RPC 端点

check_batch(values: List[str])：可批量检查多个域名、URL 或 IP 地址，返回一个包含 { value, is_safe, explanation } 的列表。
sample_blacklist(count: int)：返回黑名单条目中的随机样本，样本数量由指定参数决定。
get_source_stats()：获取详细统计信息，涵盖总条数、每个数据源的计数和最后更新时间戳。
get_update_history(source?: str, start?: str, end?: str)：获取更新历史记录，支持按来源或时间段进行过滤。
flush_cache()：清除内存中的 URL/IP 缓存，返回 { cleared: bool }。
health_check()：执行数据库和调度器的健康检查，返回 { db_ok: bool, scheduler_alive: bool, last_update: timestamp }。
add_entry(url: str, ip?: str, date?: str, score?: float, source?: str)：手动添加黑名单条目，返回 { success: bool }。
remove_entry(value: str)：根据 URL 或 IP 地址移除特定的黑名单条目，返回 { success: bool }。

📦 安装指南

创建虚拟环境

创建虚拟环境：
```
python3.12 -m venv .venv
```

激活虚拟环境：

source .venv/bin/activate  # 对于 macOS/Linux
或者
.venv\Scripts\activate  # 对于 Windows

安装 sec-mcp：
```
pip install sec-mcp
```

💻 使用示例

作为工具使用

基础用法

# 验证状态
sec-mcp status

# 更新黑名单数据库
sec-mcp update

# 批量检查文件中的内容
sec-mcp batch urls.txt

通过 API 使用

基础用法

# 导入模块并初始化
from sec_mcp import SecMCP

client = SecMCP()

高级用法

# 更新数据库
client.update()

# 单个检查
result = client.check("https://example.com")
print(result.to_json())

# 批量检查
urls = ["https://example.com", "https://test.com"]
results = client.check_batch(urls)
for r in results:
    print(r.to_json())

作为 MCP 服务器使用

基础用法

将以下内容添加到客户端的配置文件中：

{
  "mcpServers": {
    "sec-mcp": {
      "command": "/absolute/path/to/.venv/bin/python",
      "args": ["-m", "sec_mcp.start_server"]
    }
  }
}

注意事项

⚠️ 重要提示

使用虚拟环境中 Python 可执行文件的绝对路径。

对于 Windows 系统，路径可能类似于：C:\path\to\.venv\Scripts\python.exe

📚 详细文档

配置选项

可以通过 config.json 文件进行配置：

属性	详情
`blacklist_sources`	黑名单数据源地址
`batch_size`	批处理大小
`api_timeout`	API 请求超时时间（秒）

示例配置

{
  "blacklist_sources": [
    "https://example.com/blacklist.txt",
    "http://another-source.net/list"
  ],
  "batch_size": 100,
  "api_timeout": 30
}