mcp_secure-fox

Sicherer FoxMCP-MCP-Server für die Browsersteuerung.

Extrahiert SecureFoxMCPServer / SecureFoxMCPTools aus dem Gateway in ein eigenständiges, installierbares Python-Paket (secure-fox). Es umschließt den eingebetteten Upstream-FoxMCP-Server mit Domainvalidierung und Zugriffskontrolle für tabspezifische Operationen.

Upstream-Kompatibilität: Es werden nur _setup_tab_tools, _setup_navigation_tools, _setup_content_tools überschrieben. Alle anderen Tools (windows, history, bookmarks, images) werden unverändert von FoxMCPTools geerbt.

Beziehung zum Gateway

secure-fox ist bewusst vom Gateway-Paket entkoppelt:

• Das Gateway importiert securefox nicht – es greift über einen Proxy darauf zu, wie auf jedes andere Backend (k8s, netbox, grafana).

• secure-fox wird in das Gateway-/Deploy-Image installiert und über sein Konsolen-Skript securefox-mcp-server gestartet.

• Die Policy-Datei des Gateways deploy/config/policy/real/browser.yaml referenziert es als name: browser, url: http://localhost:9005/mcp.

Related MCP server: mcp-chrome-server

Konsolen-Skript

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

Die Firefox-Erweiterung verbindet sich über WebSocket (Port 8765). Der MCP-Server läuft auf Port 9005, damit der Policy-Proxy ihn auffinden kann.

Entwicklung

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

Veröffentlichung

Manueller Release-Ablauf (der Workflow testet, baut und veröffentlicht bei Tags):

1. Erhöhe die version in pyproject.toml, _version.py und __init__.py (alle Angaben müssen übereinstimmen).

2. Commit, git tag v1.2.3, dann git push && git push --tags.

3. Der Workflow führt die Tests aus und pusht ghcr.io/prog76/mcp-secure-fox:v1.2.3.

4. Lege die neue Version manuell dort fest, wo sie verwendet wird (Deploy-Umgebung: .env, SECUREFOX_VERSION). Pakete werden aus Git-Refs installiert, nicht von PyPI.