星战科技xingzhan.cloud
返回市场
猴子管理器

猴子管理器

作者：kstrikis11 星标更新：2025-02-26
安装使用来源：spider==github.com

项目介绍

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 包含两个主要组件，需要按照以下顺序安装：

  1. MCP 服务器
  2. 浏览器扩展

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 传输连接到 MCPMonkey 服务器进行 MCP 通信。一旦配置完成，Composer 中的 Cursor 代理将自动在相关情况下使用可用的 MCP 工具。

注意：在 Cursor 0.46+ 中，MCP 设置位于自己的标签页中，并且支持 .cursor/mcp.json 文件。更多详情。

2. 浏览器扩展安装

Firefox 安装

  1. 根据下面的开发说明构建项目
  2. 打开 Firefox 并导航至 about:debugging
  3. 在左侧边栏点击 "This Firefox"
  4. 点击 "加载临时附加组件..."
  5. 导航到您的 MCPMonkey 构建目录中的 dist 文件夹
  6. 选择 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 传输：外部 MCP 客户端如 Cursor 通过 stdio 传输连接

致谢

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

社区

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

许可证

此项目根据与 Violentmonkey 相同的条款许可。详情见 LICENSE 文件。

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