OLETools Secure MCP Server

OLETools Secure MCP Server

このプロジェクトは、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）
• 基本的なリスク分類のため、設定可能なスコアリングシステムを使用します
• 互換性のあるバージョンの Claude Desktop など、MCP プロトコルをサポートするシステムとの統合を想定して設計されています。

前提条件

• Python 3.6+
• OLETools：pip install oletools でインストールします
• XLMMacroDeobfuscator：pip install XLMMacroDeobfuscator でインストールします
• python-magic：pip install python-magic-bin でインストールします（Windows）
• iocextract（任意）：高度な IOC 抽出を行う場合は、pip install iocextract でインストールします
• 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 settings に移動して「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"