Firefox MCP v1.0.6

Bug fixes for interaction functions (click, hover, select, clear)\n\nAll executeScript functions now properly pass selector via IIFE parameters.

Firefox MCP v1.0.4

Fix popup version display (1.0.0 → 1.0.4)\n\nNo functional changes, only version number fix in popup.html.

Firefox MCP v1.0.3 - Enhanced Control

New Features

Navigation

• firefox_scroll - Page scrolling (up/down with pixel amount)
• firefox_refresh - Refresh current page
• firefox_go_back - Go back in browser history
• firefox_go_forward - Go forward in browser history

Interaction

• firefox_press_key - Simulate keyboard key press
• firefox_select - Select dropdown option
• firefox_clear - Clear input field value
• firefox_hover - Mouse hover over element

Direct CLI Script

• ff script for direct WebSocket control (no mcporter needed)

Usage

Direct CLI

ff navigate https://example.com
ff scroll 1000
ff press Enter
ff refresh
ff get_page_content

Installation

Download firefox-mcp-v1.0.3.xpi and install in Firefox.

Firefox MCP v1.0.1 - Bug Fixes

Bug Fixes

• navigate: 修复页面不跳转问题，改用 tabs.onUpdated 监听页面加载完成
• execute_js: 修复 executeScript requires code or file 错误
• click/type: 修复 redeclaration of const el 语法错误

Installation

下载 firefox-mcp-v1.0.1.xpi 并拖拽到 Firefox 安装。

Firefox MCP v1.0.0

Firefox MCP v1.0.0

Firefox 浏览器自动化工具，基于 Model Context Protocol (MCP) 协议。

🚀 主要功能

• 🔗 远程控制 - 通过 WebSocket 连接控制 Firefox
• 🖱️ 鼠标操作 - 点击、滚动等操作
• ⌨️ 键盘输入 - 文本输入支持
• 📸 截图 - 页面截图功能
• 🔄 标签管理 - 获取标签列表、切换标签
• 📝 内容提取 - 获取页面文本内容
• ⚡ JavaScript 执行 - 在页面执行任意 JS

📦 安装包

快速开始（推荐）

1. 下载签名扩展: firefox-mcp-v1.0.0.xpi
2. 安装到 Firefox: 打开 about:addons -> 从文件安装
3. 启动 MCP 服务器:

   cd mcp-server
   npm install
   node ws-server-v2.js

4. 使用 CLI 工具:

   mcp navigate https://example.com
   mcp scroll

🛠️ 系统要求

• Firefox 91.0+
• Node.js 18+
• Linux / macOS / Windows

📋 可用命令

命令	功能
mcp navigate <url>	导航到指定 URL
mcp scroll [pixels]	向下滚动（默认 800px）
mcp scrollup [pixels]	向上滚动（默认 800px）
mcp click <x> <y>	在指定坐标点击
mcp type <text>	输入文本
mcp content	获取页面内容
mcp url	获取当前 URL
mcp title	获取页面标题
mcp screenshot	截图
mcp js <code>	执行 JavaScript

🔧 技术架构

┌─────────────┐      WebSocket       ┌──────────────┐
│   Client    │ ◄──────────────────► │ MCP Server   │
│  (Node.js)  │   ws://localhost:34567│  (Node.js)   │
└─────────────┘                      └──────┬───────┘
                                            │
                                            │ WebSocket
                                            │
                                      ┌─────┴──────┐
                                      │  Firefox   │
                                      │ Extension  │
                                      └────────────┘

📝 完整文档

• README.md - 详细使用说明
• INSTALL.md - 安装指南

🐛 已知问题

• 首次连接可能需要刷新 Firefox 页面
• 部分网站可能有 CSP 限制影响 JavaScript 执行

🔮 未来计划

• 支持 Chrome 浏览器
• 添加更多自动化操作（下载、上传等）
• 支持多标签同时控制
• 添加录制/回放功能

📄 许可证

MIT License - 详见 LICENSE

👏 致谢

• Model Context Protocol
• Mozilla Add-ons

---

完整源码: https://github.com/HougeLangley/firefox-mcp

如有问题或建议，欢迎提交 Issue 或 PR！