Oletools MCP Server

🚀 基于OleToolsの安全MCPサーバー

このプロジェクトは、FastMCP を使用して、Microsoft Office文書（Excel、Word、PowerPointなど）や関連ファイルタイプ（XLLアドインなど）を分析するマイクロサービスを提供します。静的分析技術を用いて潜在的な悪意のあるコンテンツを検出します。このサービスは、oletools、XLMMacroDeobfuscator、pefile などの外部ツールを統合しています。

🚀 クイックスタート

このサービスを使用することで、Microsoft Office文書や関連ファイルの潜在的な悪意のあるコンテンツを検出できます。以下の手順でサービスを起動し、分析を開始できます。

✨ 主な機能

• 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（オプション）：高度な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"アプリケーションをダウンロードし、開発者設定に入り、"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"