Facetomyself/ruyi-mcp

# ruyi-mcp `ruyi-mcp` 是面向 [RuyiPage](https://github.com/LoseNine/ruyipage) 的社区 MCP Server，为 Firefox / WebDriver BiDi 提供浏览器自动化、运行时观察、指纹分析、Trace、网络拦截和人类行为模拟能力。 本项目是非官方社区集成，不代表 RuyiPage 官方项目。 ## 核心能力 - 提供 56 个 MCP 工具，覆盖页面生命周期、脚本与运行时分析、网络抓取、Cookie、DOM、Frame、请求/响应拦截、WebSocket、浏览器指纹、人类行为模拟、Session 导出和 Trace。 - 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.43`，以及由 RuyiPage 安装或兼容的 Firefox。 ## 安装 git clone https://github.com/Facetomyself/ruyi-mcp.git cd ruyi-mcp npm ci python -m pip install -r requirements.txt python -m ruyipage install npm run check ## 环境变量 - `RUYI_MCP_PYTHON`：Node Bridge 使用的 Python 可执行文件。Windows 默认使用 `python`，其他平台默认使用 `python3`。 - `RUYI_FIREFOX_PATH`：Firefox 可执行文件路径。未设置时，Bridge 会依次检查 reverse_ENV 便携目录、Windows RuyiPage 浏览器缓存和 `PATH`。 ## MCP 配置 { "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" } } } } ## 在 reverse_ENV 中使用 `ruyi-mcp` 在 reverse_ENV 中以 Public Git submodule 维护，首次使用时执行： git -C "D:\reverse_ENV" submodule update --init "mcp/ruyi-mcp" & "D:\reverse_ENV\tools\node\npm.cmd" --prefix "D:\reverse_ENV\mcp\ruyi-mcp" ci 主仓通过 gitlink 固定已验证版本；修改本项目时，应先在子仓完成验证、提交和推送，再更新 reverse_ENV 主仓中的 gitlink。 ## 验证 npm run typecheck python -m py_compile bridge/ruyi_bridge.py npm run build npm run smoke npm audit --audit-level=high `npm run smoke` 会通过 stdio 启动 MCP Server，并确认恰好注册了 56 个工具；该测试不会启动 Firefox。 ## 数据与凭据边界 - Git 中不得提交凭据、Cookie、代理密钥、浏览器 Profile、抓取数据或运行时产物。 - Python 与 Firefox 路径必须通过环境变量或运行时发现机制提供，不得提交开发者个人绝对路径。 ## License MIT，详见 [LICENSE](LICENSE)。

标签：MCP, MITM代理, Python, TypeScript, 云资产清单, 安全插件, 无后门, 浏览器自动化, 网络流量分析, 自动化攻击, 逆向工具, 逆向工程