基于OleTools的安全MCP服务器

此项目提供一个使用FastMCP分析微软办公文档（如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：在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"