pfSense MCPサーバー

自然言語でpfSenseファイアウォールを管理しましょう。327個のツール。9層の安全対策。コマンド一つで開始。

You: "Block all traffic from 203.0.113.5 on WAN"
Claude: Creates block rule → applies changes → confirms with rollback instructions

pfSense MCPサーバーは、Claude Desktop、Claude Code、およびその他のMCP互換AIクライアントを、お使いのpfSenseファイアウォールに接続します。質問、問題の診断、ファイアウォールの管理をすべて会話を通じて行えます。

なぜこれが必要なのか

pfSenseファイアウォールの管理には、Web UIのタブをクリックし、フィールド名を覚え、設定ミスで締め出されないことを祈る必要があります。このMCPサーバーを使えば、やりたいことを平易な英語で説明するだけで、AIがREST API呼び出しを処理し、入力を検証し、破壊的な操作を行う前に警告を表示します。

特徴:

• すべての破壊的な操作には明示的な確認が必要であり、何が起こるかを正確に表示します

• 削除/再起動のたびに自動的に設定をバックアップし、1行のコマンドでロールバック可能

• レート制限により、AIの暴走ループがファイアウォールにルールを大量送信するのを防ぎます

• 入力サニタイズにより、すべてのパラメータにおけるコマンドインジェクション、パストラバーサル、XSSをブロックします

Related MCP server: Firewalla MCP Server

クイックスタート

前提条件: Python 3.10以上、REST API v2パッケージがインストールされたpfSense

git clone https://github.com/gensecaihq/pfsense-mcp-server.git
cd pfsense-mcp-server
pip install -r requirements.txt
cp .env.example .env
# Edit .env: set PFSENSE_URL, AUTH_METHOD, and credentials

Claude Desktopへの接続 — ~/Library/Application Support/Claude/claude_desktop_config.json に追加します:

{
  "mcpServers": {
    "pfsense": {
      "command": "python3",
      "args": ["-m", "src.main"],
      "cwd": "/path/to/pfsense-mcp-server",
      "env": {
        "PFSENSE_URL": "https://192.168.1.1",
        "AUTH_METHOD": "basic",
        "PFSENSE_USERNAME": "admin",
        "PFSENSE_PASSWORD": "your-password",
        "PFSENSE_VERSION": "CE_2_8_0",
        "VERIFY_SSL": "false"
      }
    }
  }
}

ファイアウォールとの対話を開始 — Claude Desktopを開いて以下のように尋ねてください:

• "Show me all blocked traffic in the last hour" (過去1時間のブロックされたトラフィックをすべて表示して)

• "What services are running?" (現在実行中のサービスは何？)

• "Create a port forward for port 443 to 192.168.1.50" (ポート443から192.168.1.50へのポートフォワードを作成して)

• "Run a full system health check" (システム全体のヘルスチェックを実行して)

何ができるか

pfSenseの主要なサブシステム全体で327個のツールが利用可能です:

安全第一

本番環境のファイアウォールを管理するAIにはガードレールが必要です。このサーバーには9つの層があります:

"Delete firewall rule 5"

  1. CLASSIFY    → HIGH risk (destructive)
  2. ALLOWLIST   → tool is permitted
  3. SANITIZE    → parameters clean (no injection)
  4. RATE LIMIT  → under 10 deletes/minute
  5. DRY RUN?    → user can preview first
  6. CONFIRM     → blocked until confirm=True
  7. BACKUP      → config revision captured
  8. EXECUTE     → API call made
  9. AUDIT LOG   → action recorded with redacted params

Response includes:
  "config_backup": {
    "pre_change_revision_id": 42,
    "rollback_instruction": "restore_config_backup(revision_id=42, confirm=True)"
  }

すべての破壊的な操作（52個の削除/再起動/停止ツール）には confirm=True が必要です。すべての作成および更新操作（112個のツール）はレート制限され、サニタイズされます。すべての機密パラメータ（パスワード、キー、トークン）は、ログおよび出力で編集（隠蔽）されます。

また、以下の操作も可能です:

• dry_run=True を渡して、実行せずに破壊的な操作をプレビューする

• verify_descr="Allow HTTPS" を渡して、削除しようとしているルールが正しいか検証する（IDのずれを防ぐ）

• MCP_READ_ONLY=true を設定して、118個の読み取り専用ツール（検索、取得、診断）のみを公開する

• MCP_ALLOWED_TOOLS=search_firewall_rules,get_firewall_log を設定して、特定のツールのみに制限する

サポートされているpfSenseバージョン

jaredhendrickson13 による pfSense REST API v2パッケージ が必要です。

認証

3つのメソッドをサポート（.envで設定）:

デプロイオプション

stdio (デフォルト) — Claude DesktopおよびClaude Code用:

python3 -m src.main

HTTP — リモートアクセスおよびマルチクライアント設定用:

python3 -m src.main -t streamable-http --port 3000

Docker — 読み取り専用ファイルシステムを備えた強化コンテナ:

docker compose up

コンテナのセキュリティ: 非rootユーザー (mcp:1000)、読み取り専用ファイルシステム、すべてのケーパビリティをドロップ、noexec tmpfs、no-new-privileges。

設定

テスト

python3 -m pytest tests/ -v          # 308 tests
python3 -m pytest tests/ --cov=src   # with coverage

MCP仕様への準拠

MCP 2025-11-25 (最新) に準拠:

• 327個すべてのツールに ToolAnnotations (readOnlyHint, destructiveHint, idempotentHint) を付与

• serverInfo.version および instructions を提供

• Originヘッダーの検証 (MUST要件)

• タイミング攻撃耐性のある比較を用いたBearerトークン認証

• 仕様SHOULDに従い、デフォルトでlocalhostにバインド

• stdioおよびStreamable HTTPトランスポート

プロジェクト構造

src/
  main.py              Entry point
  server.py            FastMCP instance + API client
  client.py            pfSense REST API v2 HTTP client
  guardrails.py        9-layer defense-in-depth system
  helpers.py           Validation, parsing, safety guards
  models.py            Data models
  middleware.py        HTTP auth + Origin validation
  tools/               34 tool modules (327 tools)
tests/                 308 tests

貢献

多様なpfSense環境での実環境テストが必要です。CONTRIBUTING を参照するか、以下を行ってください:

1. フォークしてフィーチャーブランチを作成

2. python3 -m pytest tests/ -v を実行

3. PRを提出

アイデア: 実機pfSenseに対する統合テスト、追加パッケージサポート (Snort, Suricata)、OllamaローカルLLMブリッジ、マルチインスタンス管理。

ライセンス

MIT

謝辞

• jaredhendrickson13 / pfrest — pfSense REST API v2パッケージ

• JeremiahChurch — モジュール式書き換え (PR #5)

• shawnpetersen — API v2エンドポイント検出 (PR #3)

• Netgate — pfSense

• FastMCP — MCPフレームワーク