mcp_secure-fox

Servidor MCP de control del navegador Secure FoxMCP.

Extrae SecureFoxMCPServer / SecureFoxMCPTools del gateway para convertirlos en un paquete Python independiente e instalable (secure-fox). Envuelve el servidor FoxMCP vendorizado del upstream añadiendo validación de dominio a las operaciones específicas de pestañas.

Compatibilidad con el upstream: solo se sobrescriben _setup_tab_tools, _setup_navigation_tools y _setup_content_tools. El resto de herramientas (ventanas, historial, marcadores, monitorización de peticiones) se heredan sin cambios de FoxMCPTools.

Relación con el gateway

secure-fox está deliberadamente desacoplado del gateway:

• El gateway no importa securefox: hace de proxy hacia él igual que con cualquier otro backend (k8s, netbox, grafana).

• secure-fox se instala en la imagen del gateway/deploy y se lanza mediante su script de consola securefox-mcp-server.

• El archivo de políticas del gateway deploy/config/policy/real/browser.yaml lo referencia como name: browser, url: http://localhost:9005/mcp.

Related MCP server: mcp-chrome-server

Script de consola

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

La extensión de Firefox se conecta a través de WebSocket (puerto 8765). El servidor MCP se ejecuta en el puerto 9005 para que el proxy de políticas lo descubra.

Desarrollo

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

Publicación

Flujo de publicación manual (el workflow ejecuta pruebas, compila y publica al hacer tag):

1. Incrementa version en pyproject.toml, _version.py y __init__.py (mantenlas en consonancia).

2. Haz commit, git tag vX.Y.Z, y luego git push && git push --tags.

3. El workflow ejecuta las pruebas y sube ghcr.io/prog76/mcp-secure-fox:vX.Y.Z.

4. Fija manualmente la nueva versión donde se consuma (.env de deploy, SECUREFOX_VERSION). Los paquetes se instalan desde los refs de git, no desde PyPI.