mcp_secure-fox

Secure FoxMCP — это MCP-сервер для управления браузером.

Извлекает SecureFoxMCPServer / SecureFoxMCPTools из gateway в отдельный устанавливаемый Python-пакет (secure-fox). Он оборачивает вендоренный вышестоящий сервер FoxMCP, добавляя проверку доменов для операций, специфичных для вкладок.

Совместимость с вышестоящей версией: переопределены только _setup_tab_tools, _setup_navigation_tools, _setup_content_tools. Все остальные инструменты (окна, история, закладки, мониторинг запросов) наследуются без изменений от FoxMCPTools.

Связь с gateway

secure-fox намеренно отделён от пакета gateway:

• gateway не импортирует securefox — он выступает прокси для него так же, как и для любого другого бэкенда (k8s, netbox, grafana).

• secure-fox устанавливается в образ gateway/deploy и запускается его консольным скриптом securefox-mcp-server.

• Policy-файл gateway 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, чтобы policy-прокси мог его обнаружить.

Разработка

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

Релиз

Порядок ручного релиза (workflow запускает тесты, сборку и публикацию по тегу):

1. Увеличьте version в pyproject.toml, _version.py и __init__.py (значения должны совпадать).

2. Сделайте коммит, git push && git push --tags.

3. Workflow запускает тесты и отправляет образ ghcr.io/prog76/mcp-secure-fox:vX.Y.Z.

4. Вручную зафиксируйте новую версию там, где она используется (deploy .env, SECUREFOX_VERSION). Пакеты устанавливаются из git-ссылок, а не из PyPI.