Winlog Mcp

🪟 WinLog-mcp

Windows イベントログ（Application、System、Security など）を取得・分析するための Model Context Protocol（MCP）ツールです。WinLog-mcp を使うと、Windows イベントログをプログラムから取り込み、クエリできます。そのため、セキュリティ監視、インシデント対応、ログ分析の自動化に最適です。

⚠️ 警告：このツールは管理者権限で実行する必要があります。システムに意図しない変更が生じないよう、十分に注意してください。

---

✨ 機能

• Windows Sysmon ログを取り込み、ユーザーが指定したディレクトリにファイルとして保存します
• ログをクエリし、タイムスタンプに基づいて最近のイベントエントリを返し、分析やトラブルシューティングに活用できます
• MCP ツールやエコシステムとシームレスに相互運用できます

📄 ログファイルの形式

• ログファイルは、選択した保存先に <timestamp>_<log_type>.log の形式で保存されます

MCP サーバー（ツール、プロンプトなど）

🛠️ 利用可能なツール

• ingest_syslog：最近の Sysmon ログを取り込み、ファイルに書き込みます
• query_syslog：取り込んだログをタイムスタンプでクエリし、最近のイベントを返します

📋 要件

• オペレーティングシステム： Windows
• Python： 3.7 以降
• 依存関係：
  • pywin32
  • mcp.server.fastmcp（または使用する MCP サーバーの実装）

💾 インストール

リポジトリをクローンし、依存関係をインストールします。

pip install -r requirements.txt

🚀 使い方

🖥️ Sysmon のインストール

参照：Sysmon インストールガイドライン

cd sysmon
install.bat

▶️ 直接実行

ツールを MCP サーバーとして実行します。

python main.py --storage-path \\PATH\\TO\\logs\\

🧑‍💻 開発モード

MCP Inspector を使用して、調査やデバッグができます。

# Run in development mode
python \\PATH\\TO\\main.py --storage-path \\PATH\\TO\\logs\\

# Run in inspector mode
npx @modelcontextprotocol/inspector python \\PATH\\TO\\main.py --storage-path \\PATH\\TO\\logs\\

⚙️ 設定

winlog-mcp ツールを実行するための MCP 設定です。

{
  "mcpServers": {
    "winlog-mcp": {
      "command": "python",
      "args": [
        "\\PATH\\TO\\main.py",
        "--storage-path",
        "\\PATH\\TO\\logs\\"
      ]
    }
  }
}

🤖 MCP クライアントとの統合

💬 Claude Desktop との統合

設定ファイルの場所は次のとおりです。

• Windows： %APPDATA%\Claude\claude_desktop_config.json

Claude Desktop と統合すると、Claude に次のように依頼できます。

過去 24 時間の直近 10 件のイベントを表示して、分析してください。

📄 ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細については、LICENSE ファイルを参照してください。