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를 import 하지 않습니다. 다른 백엔드(k8s, netbox, grafana)와 마찬가지로 프록시할 뿐입니다.

• secure-fox는 gateway/deploy 이미지에 설치되며 콘솔 스크립트 securefox-mcp-server로 실행됩니다.

• 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에서 실행됩니다.

개발

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. 새 버전은 사용되는 곳(deploy .env, SECUREFOX_VERSION)에 수동으로 고정합니다. 패키지는 PyPI가 아니라 git refs에서 설치됩니다.