facetomyself/ruyi-mcp

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

22 stars 3 forks 품질 75 트렌드 14MIT

Repository Install

RuyiPage 브라우저 자동화, 네트워크 검사, 지문 분석 및 WebDriver BiDi 추적 워크플로우를 위한 커뮤니티 MCP 서버.

개요

ru ru ruyiPage 的社区 MCP 서버, 파이어 폭스 / WebDriver BiDi Bi、行行行、分分、Trace、和和人尾芭蕉お知らせ Mannam&Daehwa [기능개선] 하나님세상의 주일,수요 말씀 퍼가기 기능 업데이트 2015/11/02 Bi的 Bi。 - ruyi select frame.selector ru用 ruyiPage 1.2.54 的 iframe.contentWindow ,一区分doc URL 프레임。 - ruyi capture wait 会 ru ruyiPage 的 CapturePacket、None pseudo都一一SOFT MCP MC的 패킷 , max body;◡有 max式 최대BodyBodyChars > 0 Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi Bi - Node.js MCP Server 通 Python 파이썬 JSON-RPC 브리지 炉端串用 ruyiPage。

개요(AI 번역)

한국어 | Korean

ruyi-mcp] ru ruyiPage 的社区 MCP 서버, 파이어 폭스 / WebDriver BiDi Bi、行行行、分分、Trace、和和人尾芭蕉

日本國目社区, ru方,成, ru ruyiPage 方程式目。

₢ 킹

-,D,人,人,人,D,D,D,D,D,D,D、D、D、D、人、人、人、人、人、人、人、人和和。

ruyi_human_drag 白原子的人人人;ruyi_human_scroll] 小的方向原生 Wheel 小小;[T3]] 前前前放前 소스,人用“人人人 + 的短 클릭 펄스” down信 down/up/click。
ruyi_set_fingerprint ruyi_set_fingerprint] ruyi_set_fingerprint] ruyi_set_fingerprint]] ruyi_set_fingerprint]] ruyi_set_fingerprint]]] ruyi_set_fingerprint]] ruyi_set_fingerprint]] ruyi_set_fingerprint]]] ruyi_set_fingerprint]] ruyi_set_fingerprint]] ruyi_set_fingerprint]]] ruyi_set_fingerprint]]] ruyi_set_fingerprint] 파이어 폭스 原生寺。
ruyi_select_frame.selector ru用 ruyiPage 1.2.54 的 iframe.contentWindow ,区分 srcdoc URL 프레임。
ruyi_capture_wait 会多yiCapturePacket、[T10]]] ܧ一一一 MCP 一的 packets , body체;只有 [式 [ maxBodyChars > 0] R, R 유형Script R RPC R。
ruyi_attach_browser 通 Bi有 Firefox BiDi 端口, Bi;接管会 교량 都是会会 Firefox。
ruyi_capture_stop 会 MC MCP MC的//历史,T cleanupTimeout 有 Bi放 Bi Bi DataCollector, Bi 중지 式 body 몸。
Node.js MCP Server 通 Python 파이썬 JSON-RPC 브리지 炉端串用 ruyiPage。
安;安安安成,MCP 호스트 启动 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"
      }
    }
  }
}