facetomyself/ruyi-mcp

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

22 stars 3 forks Качество 75 Тренд 14MIT

Общий MCP-сервер для автоматизации браузера ruyiPage, проверки сети, анализа отпечатков пальцев и отслеживания рабочих процессов WebDriver BiDi.

Обзор

ruyi-mcp ruyiPage MCP Server, Firefox / WebDriver BiDi Trace 人 Claude Code Codex Cursor MCP - 59 MCP 中 , Cookie DOM Frame / WebSocket 人 Session Trace - ruyi human drag 国人 ;ruyi human scroll wheel ;ruyi human click source, « 人 + 国 click pulse» down/up/click - ruyi set fingerprint external window viewport screen Firefox - ruyi select frame.selector ruyiPage 1.2.54 rge iframe.contentWindow , srcdoc URL frame - ruyi capture wait ruyiPage ruyiPage CapturePacket None MCP механическая обработка тело; механическая обработка maxBodyChars > 0 , в TypeScript нагрузка RPC - ruyi attach browser Firefox BiDi , мост Firefox - ruyi capture stop MCP механическая очистка BiDi механическая обработка DataCollector, остановка механическая обработка тело Node.js MCP Server Python JSON-RPC Bridge ruyiPage 。

Обзор (машинный перевод)

中 | Английский

ruyi-mcp ruyiPage MCP Server, Firefox / WebDriver BiDi Trace 人 Claude Code Codex Cursor MCP

, интенсивная , интенсивная ruyiPage

59 MCP ligence , Cookie DOM Frame / WebSocket 人 Session Trace
ruyi_human_drag 国人 ;ruyi_human_scroll wheel ;ruyi_human_click source, « 人 + 国 click pulse»” down/up/click”
ruyi_set_fingerprint наружное окно обзорный порт экран Firefox
ruyi_select_frame.selector ruyiPage 1.2.54 , srcdoc URL frame
ruyi_capture_wait ruyiPage CapturePacket None
ruyi_attach_browser Firefox BiDi ,
ruyi_capture_stop MCP НАСТОЯЩИЙ / НАСТОЯЩИЙ, cleanupTimeout БиДи НАСТОЯЩИЙСЯ DataCollector, Stop НАСТОЯЩИЙ body Node.js MCP Server Python JSON-RPC Bridge ruyiPage
TypeScript 国 ; ,MCP Ведущий build/src/index.js

Node.js 20 。

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

ruyi-mcp

简体中文 | English

ruyi-mcp 是面向 ruyiPage 的社区 MCP Server，将 Firefox / WebDriver BiDi 浏览器自动化、运行时观察、指纹分析、Trace、网络拦截和人类行为模拟能力提供给 Claude Code、Codex、Cursor 等 MCP 客户端。

本项目由社区独立维护，是非官方集成，不代表 ruyiPage 官方项目。

核心能力

提供 59 个 MCP 工具，覆盖页面生命周期、脚本与运行时分析、网络抓取、Cookie、DOM、Frame、请求/响应拦截、WebSocket、浏览器指纹、人类行为模拟、Session 导出和 Trace。
ruyi_human_drag 提供原子的拟人拖拽动作链；ruyi_human_scroll 使用单方向原生 wheel 小步滚动；ruyi_human_click 每次点击前释放陈旧 source，并使用“拟人轨迹 + 带最终坐标的短 click pulse”派发可信 down/up/click。
ruyi_set_fingerprint 将 outer window、viewport 与 screen 分成显式参数，不再伪造 Firefox 原生窗口几何。
ruyi_select_frame.selector 使用 ruyiPage 1.2.54 的 iframe.contentWindow 映射，可精确区分 srcdoc 或同 URL frame。
ruyi_capture_wait 会把 ruyiPage 的单个 CapturePacket、None 或多包列表统一为 MCP 侧的 packets 数组，默认完整返回 body；只有显式设置 maxBodyChars > 0 才截断，并在 TypeScript 层按单包 RPC 排空批次。
ruyi_attach_browser 通过现有 Firefox BiDi 端口接管浏览器，不导航页面；接管会话与 bridge 超时恢复都不会再连带关闭 Firefox。
ruyi_capture_stop 会先清空 MCP 不再消费的队列/历史，再以 cleanupTimeout 有界释放 BiDi 订阅与 DataCollector，避免 stop 隐式补读全部 body。
Node.js MCP Server 通过常驻 Python JSON-RPC Bridge 调用 ruyiPage。
仓库跟踪 TypeScript 构建产物；依赖安装完成后，MCP Host 可直接从 build/src/index.js 启动。

环境要求

Node.js 20 或更高版本。
Python 3.10 或更高版本；当前已在 Python 3.13 上验证。
ruyiPage==1.2.54，以及由 ruyiPage 安装或兼容的 Firefox。

兼容性

ruyi-mcp	ruyiPage	Node.js	Python	验证环境
`v0.1.7`	`1.2.54`	`>=20`	`>=3.10`	MCP SDK 1.30.0 安全基线 + 27 Bridge contracts + 完整 128 KiB body runtime gate + 59 tools stdio smoke
`v0.1.6`	`1.2.54`	`>=20`	`>=3.10`	27 Bridge contracts + 完整 128 KiB body runtime gate + 59 tools stdio smoke
`v0.1.5`	`1.2.54`	`>=20`	`>=3.10`	21 Bridge contracts + 20 轮 capture runtime gate + 57 tools stdio smoke
`v0.1.4`	`1.2.54`	`>=20`	`>=3.10`	Bridge contract + TypeScript build + 57 tools stdio smoke
`v0.1.3`	`1.2.54`	`>=20`	`>=3.10`	本地：Node.js 20 + Python 3.13 + `151-proxy` runtime gate
`v0.1.2`	`1.2.50`	`>=20`	`>=3.10`	GitHub Actions：Node.js 20 + Python 3.13

仓库对 ruyiPage 使用精确版本锁定。升级兼容版本前会重新执行 Bridge contract、TypeScript build 和 59 tools stdio smoke test。

最新浏览器上游 release、commit、issue、PR 与 Trace 取舍见 docs/upstream-audit-2026-07-27.md；MCP SDK 安全更新见 docs/dependency-security-2026-07-28.md；1.2.50...1.2.54 的源码与 wheel 基线对比仍保留在 2026-07-18 审计。

安装

git clone https://github.com/Facetomyself/ruyi-mcp.git
cd ruyi-mcp
npm ci

Открыть полный README на GitHub

Установка

This server does not publish a one-line install command.

Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{
  "mcpServers": {
    "ruyi-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/ruyi-mcp/build/src/index.js"],
      "env": {
        "RUYI_MCP_PYTHON": "/absolute/path/to/python",
        "RUYI_FIREFOX_PATH": "/absolute/path/to/firefox"
      }
    }
  }
}