Sonicwall MCP Server

🚀 SonicWall MCP Server

Model Context Protocolを介した、高度なSonicWallログ分析と脅威検出を提供します。

🚀 クイックスタート

前提条件

• SonicOS 7.xまたは8.xを実行しているSonicWallデバイス
• SonicWallでAPIアクセスが有効になっていること (MANAGE > System Setup > Appliance > SonicOS API)
• DockerとDocker Compose (推奨) またはNode.js 20以上

1. サーバーを取得する

git clone https://github.com/gensecaihq/sonicwall-mcp-server.git
cd sonicwall-mcp-server

2. 環境を設定する

# サンプル設定ファイルをコピー
cp .env.example .env

# SonicWallの詳細を編集
nano .env

必要な設定:

SONICWALL_HOST=192.168.1.1
SONICWALL_USERNAME=admin
SONICWALL_PASSWORD=your_password
SONICWALL_VERSION=7  # またはSonicOS 8.xの場合は8

3. サーバーを起動する

Dockerを使用する場合 (推奨):

docker compose up -d
# またはnpmスクリプトを使用する場合
npm run docker:up

Node.jsを使用する場合:

npm install
npm run build
npm start

4. インストールを確認する

# サーバーのヘルスチェック
curl http://localhost:3000/health

# 期待されるレスポンス:
# {"status":"healthy","protocol":"MCP/2025-06-18","version":"1.0.0"}

Claudeへの接続

Claude Desktopの設定 (claude_desktop_config.json) に追加します:

{
  "mcpServers": {
    "sonicwall": {
      "transport": "sse",
      "url": "http://localhost:3000/mcp/v1/sse"
    }
  }
}

以上で完了です！ ClaudeでSonicWallの分析を開始しましょう:

"過去1時間以内にブロックされた接続を表示してください"
"今日の重大なセキュリティ脅威を見つけてください"
"VPN認証の失敗を分析してください"

✨ 主な機能

• 🔍 自然言語によるログ分析 - 会話型AIを使用してファイアウォールログをクエリできます。
• 🛡️ リアルタイムの脅威検出 - 高度な脅威相関と行動分析を行います。
• 🌐 完全なSonicOSサポート - 7.xと8.xの両方のバージョンに対応した正確なAPIエンドポイントを提供します。
• 🎯 バージョン対応型の統合 - 自動的にエンドポイントを解決し、機能を検出します。
• 🚀 エンタープライズ対応 - 包括的なセキュリティで本番環境にデプロイできます。
• 📊 高度な分析 - ネットワークインテリジェンスとセキュリティメトリクスを提供します。
• 🔒 MCP 2025-06-18準拠 - 拡張されたJSON-RPC 2.0を備えた最新のプロトコルに準拠しています。
• ⚡ 高性能 - インメモリキャッシュとインテリジェントなTTL管理を備えています。
• 🔐 セキュリティ第一 - 認証、承認、および包括的な監査ログを備えています。

🎯 最新の改善点

⚡ SonicOSサポートの強化 (v1.0.0)

• 正確なAPIエンドポイント - SonicOS 7.x (/api/sonicos) と8.x (/api/sonicos/v8) の両方に対応した完全なエンドポイントマッピング。
• バージョン対応型の機能 - バージョン固有の機能を自動的に検出して利用します。
• 高度な認証 - 適切なトークン更新とエラーハンドリングを備えた強化されたセッション管理。
• クラウド統合 - SonicOS 8.xのクラウド管理とNSM統合を完全にサポートします。

🛡️ セキュリティとコンプライアンスの強化

• MCP 2024-11-05準拠 - JSON-RPC 2.0をサポートした完全なプロトコル実装。
• 強化されたエラーハンドリング - SonicWall固有のエラーコードとインテリジェントなリトライロジック。
• 高度な検証 - AJVを使用した包括的なJSONスキーマ検証。
• セキュリティ強化 - 包括的な監査ログを備えた改善された認証フロー。

🚀 パフォーマンスと信頼性

• インテリジェントなキャッシュ - 自動クリーンアップを備えた強化されたTTL管理。
• エンドポイント最適化 - バージョン固有のタイムアウトとレート制限設定。
• 接続管理 - 改善されたリトライロジックとフェイルオーバーハンドリング。
• 包括的なロギング - パフォーマンスメトリクスとデバッグサポートを備えた構造化ロギング。

💻 使用例

基本的な使用法

// Claudeでの使用例
"Show me suspicious network activity from external IPs in the last 2 hours"
"Find brute force attacks on SSH and RDP ports"
"Analyze malware detections and their source locations"

高度な使用法

// 重要な脅威を取得する
{
  "severity": "critical",
  "limit": 20
}

// 特定のIPを調査する
{
  "sourceIp": "192.168.1.100",
  "hoursBack": 24,
  "limit": 500
}

// 上位のブロックされたIPを取得する
{
  "metric": "top_blocked_ips",
  "limit": 10
}

// セキュリティイベントをCSV形式でエクスポートする
{
  "format": "csv",
  "filters": {
    "severity": ["critical", "high"],
    "startTime": "2024-01-01T00:00:00Z"
  }
}

📚 ドキュメント

• 完全な使用ガイド - 詳細な例とユースケース
• 設定リファレンス - すべての設定を説明
• APIドキュメント - 完全なツール仕様
• トラブルシューティングガイド - 一般的な問題と解決策
• セキュリティガイド - セキュリティのベストプラクティス
• MCPコンプライアンス - プロトコルコンプライアンスの詳細

🏗️ アーキテクチャ

┌─────────────┐    ┌─────────────────┐    ┌─────────────┐
│ Claude Code │◄──►│ MCP Server      │◄──►│ SonicWall   │
│             │SSE │ (Port 3000)     │API │ Device      │
└─────────────┘    └─────────────────┘    └─────────────┘
                          │
                          ▼
                   ┌─────────────────┐
                   │ Log Analysis    │
                   │ & Intelligence  │
                   └─────────────────┘

主要なコンポーネント:

• MCPプロトコル層 - SSEトランスポートを備えた完全なMCP 2024-11-05準拠。
• 強化されたAPIクライアント - セッション管理を備えた正確なSonicOS 7.x/8.xエンドポイント。
• インテリジェントなログパーサー - バージョン固有の最適化を備えたマルチフォーマットパーシング。
• 分析エンジン - AIによる自然言語処理と脅威相関。
• パフォーマンスキャッシュ - TTL管理を備えた高性能なインメモリキャッシュ。
• セキュリティフレームワーク - 包括的な認証と入力検証。

🔧 技術詳細

基本設定

# SonicWall接続
SONICWALL_HOST=your.firewall.ip
SONICWALL_USERNAME=admin
SONICWALL_PASSWORD=secure_password
SONICWALL_VERSION=7

# サーバー設定
PORT=3000
LOG_LEVEL=info
CACHE_TTL_SECONDS=300

高度な設定

# 認証 (オプション)
MCP_BEARER_TOKEN=your_secret_token

# パフォーマンス調整
CACHE_MAX_SIZE=1000
API_TIMEOUT=30000
MAX_RETRIES=3

# セキュリティ
CORS_ORIGINS=https://claude.ai,https://localhost:3000
RATE_LIMIT_MAX=100

🐳 Dockerデプロイメント

前提条件

• Docker Engine 24.0以上 (最新の安定版)
• Docker Compose V2 (統合プラグイン、Docker Desktopに付属)
• 注意: レガシーなdocker-composeコマンドは非推奨です。docker composeを使用してください。

クイックスタートコマンド

# 本番環境デプロイメント (デタッチモード)
docker compose up -d

# 開発モード (ホットリロード付き)
docker compose -f docker-compose.yml -f docker-compose.dev.yml up

# ログを表示する
docker compose logs -f sonicwall-mcp

# すべてのサービスを停止する
docker compose down

# 再構築して再起動する
docker compose up --build -d

NPMスクリプトのショートカット

# 本番環境デプロイメント
npm run docker:up

# ホットリロード付きの開発
npm run docker:dev  

# ログを表示する
npm run docker:logs

# サービスを停止する
npm run docker:down

# イメージのみをビルドする
npm run docker:build

環境設定

# 環境ファイルを使用する
cp .env.example .env
# .envをSonicWallの詳細で編集
docker compose up -d

# または環境変数を直接渡す
SONICWALL_HOST=192.168.1.1 \
SONICWALL_USERNAME=admin \
SONICWALL_PASSWORD=your_password \
docker compose up -d

Docker Composeファイル

• docker-compose.yml - 本番環境用の設定
• docker-compose.dev.yml - 開発用のオーバーライド
• docker-compose.override.yml - ローカルのカスタマイズ (オプション)

🧪 テストと検証

クイックヘルスチェック

# サーバーのステータス
curl http://localhost:3000/health

# MCPエンドポイントのテスト
curl -H "Accept: text/event-stream" http://localhost:3000/mcp/v1/sse

SonicWall接続テスト

# 認証テスト
curl -k https://YOUR_SONICWALL/api/sonicos/auth \
  -H "Content-Type: application/json" \
  -d '{"user":"admin","password":"your_password"}'

テストスイートを実行する

# すべてのテスト
npm test

# MCPコンプライアンステスト
npm run test:mcp

# SonicWall統合テスト
npm run test:integration

🔒 セキュリティ

セキュリティ機能

• ✅ トランスポートセキュリティ - 包括的なCORS検証を備えたHTTPSの強制。
• ✅ 認証 - インテリジェントなレート制限を備えたベアラートークンサポート。
• ✅ 入力検証 - AJVを使用したJSONスキーマ検証と包括的なサニタイズ。
• ✅ コンテナセキュリティ - 読み取り専用ファイルシステムを備えた非ルートユーザー実行。
• ✅ データプライバシー - 監査対応の処理を備えたゼロ敏感データロギング。
• ✅ MCPコンプライアンス - 完全なプロトコルセキュリティ実装。
• ✅ APIセキュリティ - セキュアなセッション管理を備えたSonicWall資格情報保護。

セキュリティチェックリスト

• [ ] 信頼できるネットワークからのみAPIアクセスを有効にする。
• [ ] SonicWall管理者アカウントに強力なパスワードを使用する。
• [ ] 追加のセキュリティのためにMCP_BEARER_TOKENを設定する。
• [ ] 異常な活動を監視するためにログを監視する。
• [ ] SonicWallのファームウェアを最新の状態に保つ。
• [ ] 定期的にファイアウォールルールを確認する。

🚨 一般的な問題

❌ "Authentication Failed"

問題: SonicWall APIに接続できません。

# APIが有効になっていることを確認する
# SonicWall: MANAGE > System Setup > Appliance > SonicOS API ✓

# 接続性をテストする
ping YOUR_SONICWALL_HOST
curl -k https://YOUR_SONICWALL_HOST/api/sonicos/auth

❌ "No logs returned"

問題: ログクエリから空のレスポンスが返されます。

# SonicWallのログレベルを確認する
# Log > Settings > Categories > 必要なログタイプを有効にする

# 時刻同期を確認する
date

❌ "CORS Error in Browser"

問題: ブラウザがMCPリクエストをブロックします。

# あなたのドメインをCORS_ORIGINSに追加する
CORS_ORIGINS=https://claude.ai,https://your-domain.com

📊 モニタリングと可観測性

ヘルスモニタリング

# 詳細なヘルスステータス
curl http://localhost:3000/health | jq

# レスポンスに含まれる内容:
# - サーバーの稼働時間とステータス
# - SonicWallの接続性
# - キャッシュ統計情報
# - メモリ使用量

パフォーマンスメトリクス

# パフォーマンスログを表示する
docker compose logs sonicwall-mcp | grep "executed successfully"

# 出力例:
# {"timestamp":"2024-01-01T12:00:00.000Z","level":"info","message":"Tool analyze_logs executed successfully","executionTime":245,"resultSize":15420}

ログ分析

# エラー監視
docker compose logs sonicwall-mcp | grep ERROR

# パフォーマンス追跡
docker compose logs sonicwall-mcp | grep "execution time"

🤝 コントリビュート

私たちはコントリビューションを歓迎します！ コントリビューションガイドライン をご覧ください。

開発環境のセットアップ

# フォークしてクローンする
git clone https://github.com/your-username/sonicwall-mcp-server.git
cd sonicwall-mcp-server

# 依存関係をインストールする
npm install

# 開発サーバーを起動する
npm run dev

# テストを実行する
npm test

# PRを送信する
git checkout -b feature/amazing-feature
git commit -m "Add amazing feature"
git push origin feature/amazing-feature

📄 ライセンス

MITライセンス - 詳細は LICENSE ファイルを参照してください。

🆘 サポートとコミュニティ

• 🐛 問題報告: GitHub Issues
• 💬 ディスカッション: GitHub Discussions
• 📚 ドキュメント: プロジェクトWiki
• 📧 セキュリティ: security@yourorganization.com

🙏 謝辞

• Model Context Protocol の素晴らしい仕様
• SonicWall の包括的なAPIドキュメント
• Claude Code コミュニティのフィードバックとテスト
• このプロジェクトをより良くするすべてのコントリビューターとユーザー