mcp_secure-fox

Secure FoxMCP 浏览器控制 MCP 服务器。

将 SecureFoxMCPServer / SecureFoxMCPTools 从网关中提取出来，封装为独立的、可安装的 Python 包（secure-fox）。它封装了随附的上游 FoxMCP 服务器，并在标签页特定操作上增加了域名验证。

上游兼容性：仅覆盖 _setup_tab_tools、_setup_navigation_tools、_setup_content_tools。其他所有工具（窗口、历史记录、书签、请求监控）都原样继承自 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）。这些包从 git refs 安装，而不是从 PyPI 安装。