OLETools Secure MCP Server

OLETools 安全 MCP 服务

该项目使用 FastMCP 提供安全的微服务，通过静态分析技术检查 Microsoft Office 文档（Excel、Word、PowerPoint）及相关文件类型（如 XLL 加载项）中可能存在的恶意内容。它借助 oletools、XLMMacroDeobfuscator 和 pefile 等外部工具。

功能

• 分析 VBA 宏（olevba）
• 检测 XLM 宏（XLMMacroDeobfuscator、olevba）
• 检查 DDE 链接（msodde）
• 提取嵌入的 OLE 对象（oleobj）
• 分析 XLL 文件导出项中的可疑函数（pefile）
• 使用 iocextract 提取 IOC（URL、IP、哈希、电子邮件）
• 提供基本的 MIME 类型和文件大小验证（python-magic）
• 使用可配置的评分系统进行基本风险分类
• 专为集成到支持 MCP 协议的系统而设计（例如兼容版本的 Claude Desktop）。

前置条件

• Python 3.6+
• OLETools：通过 pip install oletools 安装
• XLMMacroDeobfuscator：通过 pip install XLMMacroDeobfuscator 安装
• python-magic：通过 pip install python-magic-bin 安装（Windows）
• 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”应用程序，进入 Developer 设置并编辑“claude_desktop_config.json”文件，然后将 configuration.json 文件中的内容粘贴进去。重启应用程序。
4. 运行配置文件：

python config.py

6. 运行服务：

python mcp_service.py

9. 打开“Claude Desktop”应用程序并检查是否出现“锤子图标”；如果出现，则表示 MCP 工具已可用。
10. 输入“analyze_vba_macros in <filepath\example.xlsm>”，即可对 Excel 文件进行静态分析并查看分析结果。

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