Sec MCP

sec-mcp是一個Python安全檢測工具包，提供域名、URL、IP等的安全檢查功能，支持Python應用集成、終端CLI使用或作為MCP服務器運行，為LLM提供即時威脅洞察。

安全人工智能聊天機器人 #安全檢測 #黑名單檢查 #即時威脅 #LLM集成 .Python

評分 : 2分

下載量 : 14

更新時間 : 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

使用說明

作為工具使用

驗證狀態：

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 服務器使用

配置 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

✨ 主要特性

新增功能

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 }。

配置選項

可以通過 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
}