@warriorteam/redai-browser-mcp

MCP cục bộ cho RedAI Browser Automation Extension. Từ phiên bản 0.3.0, một daemon dùng chung giữ kết nối WebSocket với extension; mỗi Codex thread chỉ chạy một stdio proxy nhẹ. Vì vậy nhiều thread có thể dùng cùng một trình duyệt mà không tranh cổng 8082.

Đăng ký với Codex

codex mcp add redai_browser -- npx -y @warriorteam/redai-browser-mcp@latest

Hoặc cấu hình TOML:

[mcp_servers.redai_browser]
command = "npx"
args = ["-y", "@warriorteam/redai-browser-mcp@latest"]

Lần đầu chạy, package tự tạo token trong thư mục cấu hình và tự bật daemon. Lấy token để nhập vào extension:

npx -y @warriorteam/redai-browser-mcp@latest pairing show

Giữ URL extension là ws://127.0.0.1:8082. Không thêm token vào lệnh Codex; tùy chọn --token đã bị loại bỏ để secret không xuất hiện trong process list.

Quản lý daemon

npx -y @warriorteam/redai-browser-mcp@latest daemon start
npx -y @warriorteam/redai-browser-mcp@latest daemon status
npx -y @warriorteam/redai-browser-mcp@latest daemon stop
npx -y @warriorteam/redai-browser-mcp@latest pairing rotate

Đóng một Codex thread chỉ ngắt proxy của thread đó, không tắt daemon và không làm mất kết nối extension. Daemon bind duy nhất vào 127.0.0.1, nhận tối đa 64 agent và thực thi lệnh trình duyệt theo FIFO, một lệnh tại một thời điểm.

Các tùy chọn runtime: --port, --timeout, --diagnostics. Biến môi trường hỗ trợ: REDAI_BROWSER_MCP_CONFIG_DIR, REDAI_BROWSER_MCP_PORT, REDAI_BROWSER_MCP_TIMEOUT_MS, REDAI_BROWSER_MCP_DIAGNOSTICS.

Khắc phục lỗi

• EXTENSION_DISCONNECTED: mở/reload extension và kiểm tra URL/token.
• DAEMON_UNAVAILABLE: chạy daemon status, sau đó daemon start.
• AUTHENTICATION_FAILED: chạy pairing show rồi cập nhật token trong extension.
• PROTOCOL_MISMATCH: cập nhật đồng thời npm package và extension lên 0.3.x.
• BRIDGE_BUSY: queue đang đầy; chờ và thử lại.

Package không expose arbitrary JavaScript/shell execution. Diagnostics cần bật đồng thời trong MCP, Options của extension và Chrome optional permission debugger.