Provides a local CLI/MCP bridge to the UiPath Browser Automation Chrome extension, enabling status checks, driver version discovery, opening HTTP(S) URLs in new tabs, and retrieving tab URL/title/load status. It also supports handshaking with the embedded UiPath driver, but does not yet implement clicking, typing, or DOM reading.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Local CLI/MCP bridge cho extension UiPath trên Chrome: source static catalog định nghĩa 57 tool gồm bốn API legacy, browser_capabilities và 52 adapter browser. Trong 52 adapter, 42 tool core có receipt live lịch sử; mười tool advanced nay có source backend riêng và readiness gates. MCP/native host đang chạy chưa được reload, nên đây mô tả source/test catalog, không xác nhận tool list trong process hiện tại. Xem coverage runtime, schema input/output và trạng thái backend advanced. Source/unit test không đồng nghĩa Companion đã cài hoặc tool đã chạy live.
git clone https://github.com/OrgGem/rpa-agent-mcp.git
cd rpa-agent-mcp
npm ci
npm testYêu cầu runtime: Windows, Node.js 22.22.2+ (v22) hoặc 24.15+ và extension UiPath đã cài riêng. Xem phần cài đặt bên dưới để đăng ký native host. Các file native-host.json, native-host.cmd và registration-before.json được Setup.ps1 sinh trên máy cài và không được commit.
Bản thử nghiệm đã được kiểm chứng với extension UiPath Browser Automation 23.10.1. Native host riêng cung cấp kết nối cho CLI và MCP; không cần chương trình ChromeNativeMessaging.exe của UiPath cho các thao tác đã triển khai.
Receipt public trước đợt advanced backend đạt 7/7 nhóm và42/42 tool core trên fixture hai origin/React theo source hashes ghi trong receipt. Receipt đó không kiểm chứng mười tool advanced hoặc source hashes hiện tại, nên không được coi là live acceptance của toàn bộ 52 adapter. Xem kết quả và giới hạn và tiến độ phase.
status: xem native host có kết nối hay không và số cửa sổ đã đăng ký.
versions: gửi GetEmbeddedDriverVersions đến extension và nhận phản hồi theo requestId / returnId.
activate: nạp và handshake với driver 23.4.55.39317 có sẵn trong extension.
open URL: mở URL HTTP(S) trong tab mới bằng lệnh UiPath OpenTab.
tab ID: đọc URL, tiêu đề và trạng thái tải bằng GetHtmlAttribute.
active, find URL_PATTERN: các lệnh chẩn đoán chỉ đọc.
mcp: MCP STDIO với session/tab/navigation, DOM read/snapshot/find/wait, input, iframe, evaluate, form/table/tree/date, watchers, cookies và ảnh.
browser_capabilities({}): snapshot không dispatch browser action. Host mới trả schema v2 với connectionRef, tool availability, giới hạn và unsupported reasons. Availability không chứng nhận mọi option đã live; receipt G0 lịch sử tách khỏi acceptance public tool mới.
Mười tool advanced dùng backend riêng theo từng tool/mode. OCR là tùy chọn và thiếu OCR chỉ làm browser_ocr unavailable; semantic AX cần Companion nhưng không cần Ollama. Chỉ natural-language mode mới cần model Ollama được cấu hình tường minh. Caller có thể đọc screenshot artifact rồi tự gửi cho model đa phương thức của mình; runtime không tự gửi ảnh hay gọi provider. tools/list là catalog tĩnh; restart MCP/native host để process mới nạp source rồi gọi browser_capabilities xem readiness. Companion phải được build, load và đăng ký riêng; upload roots, Ollama model và profile launch chỉ cần cấu hình cho các tool tương ứng. Chi tiết có trong bảng backend.
Hướng dẫn agent: attach, refs, requestKey, xử lý lỗi, input method, artifact và cleanup.
Không phân phối lại mã extension của UiPath. Giao thức được khảo sát từ bản đã cài; chưa có cam kết tương thích các phiên bản khác. Xem verification.json để biết kết quả kiểm chứng thực tế, tách khỏi kiểm thử với extension mô phỏng.
Mốc bootstrap lịch sử ngày 2026-10-25: native host được Chrome khởi chạy, CLI và MCP STDIO nhận được 6 phiên bản driver từ extension thật. MCP đã mở https://www.google.com/ qua OpenTab, rồi đọc lại URL, tiêu đề Google và trạng thái complete từ tab ID 561209531. Hash BackgroundMain.js không đổi so với trước khi đăng ký host. Tại mốc bootstrap này chưa kiểm chứng click hoặc nhập liệu; public runtime hiện tại có receipt riêng ở trên.
Native host trả lời LoadScripts bằng metadata phiên bản và stub return null; để từ chối driver bên ngoài; extension chọn package nhúng tương thích. Không sao chép mã driver UiPath vào dự án. Prototype ghim driver 23.4 đã kiểm chứng trong extension 23.10.1; chưa cam kết với phiên bản extension khác.
OpenTab chỉ gửi một lần. Nếu metadata chưa sẵn sàng, adapter đọc lại metadata, không mở tab lặp. Kết quả giữ ID tab đã tạo kể cả khi chưa xác minh tải xong. Chỉ URL HTTP(S) không chứa thông tin đăng nhập được chấp nhận.
Related MCP server: chrome-profile-debug
ChatGPT/Codex → MCP STDIO → IPC named pipe → native host → Chrome Native Messaging → extension UiPath
Cùng entry point src/bridge.mjs, nhưng mcp và native là hai tiến trình: ChatGPT chạy phía MCP; Chrome chạy native host. IPC điều phối các thao tác trạng thái, phiên bản, nạp driver, mở URL và đọc thông tin tab cùng các lệnh chẩn đoán cố định; thông điệp được giới hạn 1 MiB và có timeout.
Guide tổng quan và đầy đủ tên lệnh: 88 tên lệnh driver, 4 lệnh loader và các tuyến GenericRequest.
Catalog JSON: trường request quan sát được theo từng phiên bản, tên handler, offset và SHA256 nguồn.
Ma trận triển khai đầy đủ: từng function/loader/callback/generic/content → adapter → MCP consumer → task/phase → test; unsupported có lý do và tuyến thay thế. JSON dùng cho validator.
Danh mục phản ánh các entry trong mã extension 23.10.1; những lệnh chưa triển khai trong bridge không tự trở thành MCP tool.
Feature catalog cho agent: 47 nhóm tính năng, 53 tên tool đề xuất, 21 tool ưu tiên MVP; input/output và tiêu chí nghiệm thu.
Mapping 168 tên activity UiPath: Modern, Classic, Semantic và hai helper Workflow được chọn; có phân loại phần cần backend riêng hoặc ngoài browser core.
Hợp đồng MCP: context/ref, locator, errors, timeout/retry, watchers và ví dụ luồng agent.
Đặc tả đã được đối chiếu lại với extension ngày 2026-10-26, có audit route, probe cô lập và receipt metadata live. Receipt metadata kiểm tra bốn API legacy; kiểm chứng DOM/input riêng ở các receipt G0 bên dưới.
Catalog activity và ma trận cũ là baseline kế hoạch. Runtime mới dùng typed isolated DOM script cho nhiều chức năng; native literal discovery/iframe dùng FindSelectors, native click dùng GenericRequest 6, native text dùng WriteTextHtmlElem 0/4. GetHtmlValue generic 5 chỉ là route private G0 lịch sử; public read dùng script DOM. Không coi tên activity là bằng chứng endpoint vendor được gọi. Coverage từng protocol row ghi rõ wired, dom-composite và not-wired.
Xem task theo phase,
quy trình EGM và hợp đồng code.
Slice đầu triển khai capability discovery, kiểm thử offline và giữ API cũ.
Task kế tiếp đã thêm fixture/runner và private probe G0, tắt mặc định, không public
DOM tool mới. Xem cách chạy preflight/live
và npm run matrix:check để kiểm tra coverage của plan.
Đã chuyển sang host repo mới và chạy G0 main-frame smoke live đạt:
find 0/1/2, đọc value, replace/append Unicode và click counter có report độc lập;
tab/server cleanup đạt. Probe đã tắt lại trên host đang kết nối. Đây chưa phải full
G0 hoặc API DOM công khai. G0.4 live đã đạt
11/11 ca stale/remove/clone/reload/navigation/native reconnect, same/cross-origin
iframe và React 19.3.1 controlled DOM/model sau rerender. Hai lần lỗi được giữ cùng
bản sửa readiness/not-found semantics; 32/32 offline tests đạt. Fixture/server
cleanup và tắt probe cả trong tiến trình lẫn launcher đã xác nhận. Guard fixture
không bảo đảm atomic identity/dispatch hoặc mọi framework/site; general DOM API
được giữ là bằng chứng lịch sử. Runtime public mới cần receipt riêng từ node scripts/run-browser-live.mjs --live; kết quả hiện tại nằm trong plan.
Receipt tổng hợp có xác nhận UI độc lập rằng cửa sổ fixture đã biến mất; raw
CloseBrowser acknowledgement không tự được coi là cleanup pass.
Xem receipt host và
kiểm tra MCP 5 tool. Giữ trang nền
UiPath Web Automation mở; nó khác fixture thử nghiệm có thể đóng.
Capability trả bằng chứng live lịch sử có ngày/nguồn; gọi discovery không tạo
receipt live mới. Open/tab metadata chỉ báo available khi status xác nhận driver
ghim đã nạp; dùng legacy open/activate khi cần nạp driver có chủ đích.
Yêu cầu Windows, Node.js 22.22.2+ (v22) hoặc 24.15+, Chrome và đúng extension đã khảo sát.
.\Setup.ps1 -Mode Install
node .\src\bridge.mjs status
node .\src\bridge.mjs versions
node .\src\bridge.mjs open https://www.google.com
node .\src\bridge.mjs tab 561209531Setup tạo manifest cùng launcher .cmd, đăng ký HKCU com.uipath.chromenativemsg_v2. Nó từ chối ghi đè host khác, lưu trạng thái trước khi cài vào registration-before.json, và không thay đổi extension hoặc policy Chrome.
Nếu extension chưa tự kết nối lại, tắt/bật extension UiPath trong chrome://extensions sau khi các tác vụ trình duyệt hoàn tất. Không cần thoát Chrome bằng cách cưỡng bức dừng tiến trình.
Trên máy kiểm chứng, bốn tool đã được gọi thành công bằng MCP client local riêng; chưa xác nhận việc khám phá tool trong mọi giao diện ChatGPT/Codex. Sau khi clone, cấu hình MCP client của bạn với command node và hai arguments: đường dẫn tuyệt đối tới src/bridge.mjs, rồi mcp.
mcp.example.toml dùng đường dẫn placeholder; thay bằng vị trí clone của bạn. Có thể dùng đường dẫn tuyệt đối đến node.exe nếu client không nhận PATH.
npm test
node .\Verify-Live.mjs
.\Setup.ps1 -Mode Status
.\Setup.ps1 -Mode Uninstall
codex mcp remove uipath_bridgeUninstall chỉ xóa đăng ký do prototype này tạo. Host đang chạy kết thúc khi Chrome ngắt kết nối; chương trình không cưỡng bức đóng Chrome. Giữ nguyên thư mục dự án khi đang dùng host hoặc cấu hình MCP trỏ vào đó.
Demo có điều hướng thật: node .\Verify-Live.mjs --open-url https://www.google.com. Tùy chọn này mở tab mới; lệnh kiểm chứng mặc định không mở trang web.
Các script audit, probe và sinh tài liệu nằm trong scripts. Receipt đã commit là bằng chứng lịch sử; đường dẫn máy được thay bằng placeholder. Giấy phép MIT của repository áp dụng cho code bridge và công cụ của dự án; extension UiPath được cài riêng và không được phân phối trong repository.
Chrome Native Messaging: https://developer.chrome.com/docs/extensions/develop/concepts/native-messaging
MCP local trong ChatGPT/Codex: https://learn.chatgpt.com/docs/extend/mcp
MCP STDIO: https://modelcontextprotocol.io/specification/2025-06-18/basic/transports
Bản extension được khảo sát: ID jfcmnbofjlffnejneillkgbniiidiigd, phiên bản 23.10.1, Manifest V3.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Local Chrome and BYO browser automation through MCP, with secure manual handoff.
Browserless MCP — wraps the Browserless headless-Chromium REST API (browserless.io)
Hosted real Google Chrome MCP with per-user persistent state. Navigate, click, type, screenshot.
Browser MCP for logged-in tasks. Uses your Chrome — credentials stay local. Zero-token replay.
