facetomyself/ruyi-mcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

22 stars 3 forks 品質 75 トレンド 14MIT

Repository Install

RuyiPageブラウザの自動化、ネットワーク検査、指紋解析、WebDriver BiDiのトレースワークフローのコミュニティMCPサーバー.

概要

ruyi-mcp 是面方向 ruyiPage の社区 MCP サーバー、Firefox / WebDriver BiDi サーバ自作、移動行時間、棒、棒、分析、网和基金和人組供供供品供品供品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品品最本本本本本本本本本本本本本本本本 Web Web Web Web Web Web Web Web Web Web 释 “ “ “ “ “ “ “ “ “ “ “ “ “ “ “ “ “ “ “ “ “ “ “ “ “ “ “ “ “ “ “ “ “ Eメール: [email protected] - Node.js MCP Server は、通常のPython JSON-RPC Bridge の ruyiPage を使用する。

概要（AI 翻訳）

日本語 | English

[ruyi-mcp] 是面方向 ruyiPage の社区 MCP Server, 将 Firefox / WebDriver BiDi のサーバ自动化,直行時間短縮, 棒断面解析,Trace, 网网基金和人組献身的提供クローデコード,Codex,Cursor 等 MCP 客先順.

项是非是非是非是非是非是非代表代表代表项项项项项项项项项项项项项项项项项项项项项项项项项项项项项。。。。。。。。。。。。。。。。。。。。。。。。。。。。

核心能力

请本本本本本本本本本本本本本本本本本本 Web Web Web Web Web Web Web Web Web Web Web Web 本本本本本本本本本请请请请请请请请请请请请请请请请请请请请请请请请请请

[[ruyi_human_drag] 提供放射線人拖拽动作;[[[ruyi_human_scroll]]] 利用教原方向性小小;[ruyi_human_click]]]] 旧次次旧 “ 最最最最最最最最最最最最最最最最最最最最最最最最最最最最最最最最最最最最最最最最最最最最 ” ” ” ” ” ” ” ” ” ” ” ” ” ” ” ” ” ” ” ” ” ” ” ” ” ” ” ” ” ” ” ” ” ” ” ” ” ” ” ” ” ” ” ” ” ” ” ” ” ” ” ” ” ”
[[ruyi_set_fingerprint] 将アウターウィンドウ、viewport 与画面分成式数、不再構成 Firefox の原生
[[ruyi_select_frame.selector] ruyiPage 1.2.54 の [[[iframe.contentWindow]]]] の [[srcdoc]]] と [同じ URL フレーム。
[[ruyi_capture_wait] 会 CapturePacket] None]] 或一一一一 packets 默认默认默认默认默认 maxBodyChars > 0] 才才才在次次次次次次次次次次次次次次次次次次次次次次次次次次次次次次次次次次次次次次次次次
[[ruyi_attach_browser] 通有有Firefox BiDi端口口口口口口接記器, 不首页面;接客会席橋超时都都会不会会 Firefox.
[[ruyi_capture_stop] 会先清空 MCP 不再消息/行列/再構成 [cleanupTimeout]] 有界外伝美Di 订阅 stop stop 体.
Node.js MCP Server は、通常のPython JSON-RPC Bridge の ruyiPage を使用する。构构构构构构构构安构ホスト可直接 build/src/index.js] 。

境

Node.js 20 または高版本。

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

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

GitHub で README 全文を見る

インストール

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"
      }
    }
  }
}