Oletools MCP Server

🚀 基於OleTools的安全MCP服務器

本項目搭建了一個微服務，藉助FastMCP對微軟辦公文檔（像Excel、Word、PowerPoint等）以及相關文件類型（例如XLL加載項）展開分析。運用靜態分析技術，可檢測出文檔中潛藏的惡意內容。此服務集成了oletools、XLMMacroDeobfuscator和pefile等外部工具。

✨ 主要特性

• 宏分析：能夠分析VBA宏 (olevba)，檢測XLM宏 (XLMMacroDeobfuscator, olevba)。
• 鏈接檢查：可檢查DDE鏈接 (msodde)。
• 對象提取：支持提取嵌入的OLE對象 (oleobj)。
• 函數分析：能分析XLL文件導出的可疑函數 (pefile)。
• IOC提取：使用iocextract提取IOC（URL、IP、哈希、郵件）。
• 文件驗證：提供基於MIME類型和文件大小的基本驗證 (python-magic)。
• 風險分級：配置評分系統以實現基礎風險分級。
• 系統集成：設計用於與支持MCP協議的系統集成（如兼容版本的Claude Desktop）。

📦 安裝指南

先決條件

• Python 3.6及以上版本
• OLETools：通過 pip install oletools 安裝
• XLMMacroDeobfuscator：通過 pip install XLMMacroDeobfuscator 安裝
• python-magic：在Windows上通過 pip install python-magic-bin 安裝
• iocextract（可選）：通過 pip install iocextract 安裝以實現高級IOC提取
• Claude Desktop應用程序

安裝步驟

1. 克隆倉庫：

   git clone https://github.com/pradeep895/oletools-mcp-server.git
   cd oletools-mcp-server
   

2. 安裝依賴項：

   pip install -r requirements.txt
   

3. 下載"Claude Desktop"應用程序，進入開發者設置並編輯"claude_desktop_config.json"文件，將內容粘貼到配置文件中。重啟應用程序。
4. 運行配置文件：

   python config.py
   

5. 啟動服務器：

   python mcp_service.py
   

6. 在"Claude Desktop"應用程序中檢查是否出現“錘子圖標”，表示MCP工具已可用。
7. 輸入命令 analyze_vba_macros in <filepath\example.xlsm> 以分析Excel文件並獲取結果：

   analyze_vba_macros file_path:"C:\path\to\your\example.xlsm"