MCPMonkey

MCPMonkey 是 Violentmonkey 的一个分支，扩展了其强大的用户脚本功能，以支持模型上下文协议（MCP）服务器。该项目旨在弥合AI语言模型与浏览器交互之间的差距。

关于 MCPMonkey

MCPMonkey 增强了 Violentmonkey 的浏览器扩展功能，提供了一个用户友好的界面来管理和使用模型上下文协议（MCP）服务器。这使得像 Cursor 中使用的AI语言模型能够以有意义的方式与您的浏览器进行交互。

当前功能

MCPMonkey 目前实现了以下关键功能：

标签页管理（browserAction 工具）：
- 获取所有打开标签页的信息
- 创建新标签页
- 关闭标签页
- 激活（聚焦）标签页
- 复制标签页
页面样式提取（getPageStyles 工具）：
- 从网页中提取样式信息以供AI分析
- 返回有关样式的结构化JSON数据
- 包括全局样式、计算样式、配色方案、排版
用户脚本支持：完全兼容现有的用户脚本（继承自 Violentmonkey）

计划中的功能

以下功能计划在未来的开发中实现：

MCP 服务器管理：直接从浏览器中安装和管理多个MCP服务器
增强的浏览器访问：允许AI工具与以下内容进行交互：
- 浏览历史
- 书签
- 开发者控制台日志
- 其他已安装的扩展
权限控制：精细控制每个MCP服务器可以访问的资源
社区中心：分享和发现MCP服务器和脚本

Cursor MCP 集成

MCPMonkey 由两个主要组件组成，需要按以下顺序安装：

MCP 服务器
浏览器扩展

1. 将 MCP 服务器添加到 Cursor

使用已发布的 NPM 包：

在 Cursor 中，转到 设置 > 功能 > MCP 服务器
点击 + 添加新 MCP 服务器 按钮
配置连接：
- 名称：mcpmonkey-server
- 类型：命令
- 命令：npx mcpmonkey-server

或者如果自己构建：

# 导航到服务器目录
cd mcpmonkey-server

# 安装依赖
yarn

# 构建服务器
yarn build

# 运行服务器
node build/index.js

在 Cursor 中配置：
- 名称：mcpmonkey-server
- 类型：命令
- 命令：node /绝对路径/to/mcpmonkey-server/build/index.js

Cursor 使用 stdio 传输进行 MCP 通信，连接到 MCPMonkey 服务器。一旦配置完成，Cursor 的 Composer 中的 Agent 将在相关时自动使用可用的 MCP 工具。

注意：在 Cursor 0.46+ 中，MCP 设置位于其自己的选项卡中，并且支持 .cursor/mcp.json 文件。更多信息。

2. 浏览器扩展安装

Firefox 安装

按照下面的开发说明构建项目
打开 Firefox 并导航到 about:debugging
点击左侧边栏中的 "This Firefox"
点击 "Load Temporary Add-on..."
导航到 MCPMonkey 构建目录中的 dist 文件夹
选择 dist 文件夹中的任何文件以加载扩展

注意：由于这是临时安装，每次重新启动 Firefox 时都需要重新加载扩展。

我们计划很快提供 .xpi 文件。

MCPMonkey 的浏览器工具

我们实现的 MCP 工具为像 Cursor 中的AI语言模型提供了强大的浏览器交互功能：

browserAction 工具：
- 获取所有打开标签页的信息
- 创建新标签页
- 关闭标签页
- 激活（聚焦）标签页
- 复制标签页
getPageStyles 工具：
- 提取页面样式信息（全局样式、计算样式、配色方案、排版）
- 返回结构化JSON数据以供AI分析
- 使用内容脚本桥与网页进行通信

这些工具使AI模型能够通过端口 3025 上的 WebSocket 连接与您的浏览会话进行有意义、上下文感知的交互。

为了开发和测试，您可以运行带有 MCP 检查器的服务器：

# 使用 MCP 检查器运行以进行调试
npx @modelcontextprotocol/inspector node build/index.js

服务器实现了 stdio 和 WebSocket 接口，WebSocket 服务器在端口 3025 上运行，用于与浏览器扩展的内部通信。

使用案例

对于开发者：
- 直接从 Cursor 或其他AI工具访问浏览器资源
- 在您的AI开发环境中查看控制台日志和调试信息
- 为特定开发需求创建自定义MCP服务器
对于用户：
- 让您的桌面聊天机器人帮助您找到上周访问的网站
- 允许AI工具起草社交媒体消息或电子邮件
- 通过自然语言命令自动化浏览器交互

开发

扩展开发

安装 Node.js 和 Yarn v1.x。
Node.js 的版本应与 package.json 中的 "node" 键匹配。

# 安装依赖
$ yarn

# 监视并编译
$ yarn build

然后从 'dist/' 加载扩展。

技术细节

当前实现的技术组件：

WebSocket 通信：扩展和服务器通过端口 3025 上的 WebSocket 进行内部通信
内容脚本桥：通过安全消息传递与网页内容进行交互
Zod 模式验证：通过运行时类型检查确保组件之间的数据完整性
Stdio 传输：像 Cursor 这样的外部MCP客户端通过 stdio 传输连接

致谢

该项目基于 Violentmonkey，这是一个优秀的用户脚本管理器，为 MCPMonkey 的增强功能提供了基础。我们向 Violentmonkey 团队和贡献者表示衷心的感谢，感谢他们的出色工作。

社区

https://mcpmonkey.com - 获取更多文档和MCP工具脚本

许可证

该项目与 Violentmonkey 使用相同的许可证。有关详细信息，请参阅 LICENSE 文件。

我们未来可能会添加付费功能。