mcp_secure-fox

SecureFox MCPは、ブラウザ制御用のMCPサーバーです。

SecureFoxMCPServer / SecureFoxMCPTools をゲートウェイから抽出し、スタンドアロンでインストール可能なPythonパッケージ（secure-fox）にします。同梱されたアップストリームのFoxMCPサーバーを、タブ固有の操作に対するドメイン検証付きでラップします。

アップストリーム互換性：オーバーライドされるのは _setup_tab_tools、_setup_navigation_tools、_setup_content_tools のみです。その他のツール（windows、history、bookmarks、request monitoring）はすべて FoxMCPTools から変更なしで継承されます。

ゲートウェイとの関係

secure-fox は意図的にゲートウェイパッケージから分離されています：

• ゲートウェイは securefox をインポートしません — 他のバックエンド（k8s、netbox、grafana）とまったく同じように、プロキシするだけです。

• secure-fox はゲートウェイ/デプロイイメージにインストールされ、そのコンソールスクリプト securefox-mcp-server によって起動されます。

• ゲートウェイのポリシーファイル deploy/config/policy/real/browser.yaml では、name: browser、url: http://localhost:9005/mcp として参照されます。

Related MCP server: mcp-chrome-server

コンソールスクリプト

securefox-mcp-server --mcp-port 9005 --ws-port 8765

Firefox拡張機能はWebSocket（ポート8765）を介して接続します。MCPサーバーは、ポリシープロキシが検出できるよう、ポート9005で稼働します。

開発

pip install -e ".[dev]"
python -m pytest

リリース

手動リリースの手順（ワークフローはタグ時にテスト/ビルド/公開します）：

1. pyproject.toml、_version.py、__init__.py の version を更新します（それぞれ一致させてください）。

2. コミットし、git tag vX.Y.Z を打ってから、git push && git push --tags を実行します。

3. ワークフローがテストを実行し、ghcr.io/prog76/mcp-secure-fox:vX.Y.Z をプッシュします。

4. 新しいバージョンを、それが使われる環境（デプロイ .env の SECUREFOX_VERSION）で手動でピン留めします。パッケージはPyPIからではなく、git参照からインストールされます。