
hp-jh/tarsuitarsbridge
Developer toolsMCP bridge for ByteDance UI-TARS — independent desktop GUI agent project, pluggable into TarsSecureGuard (TSG) gateway via auto-include registry
Overview
MCP Bridge for UI-TARS — connects TSG gateway to UI-TARS desktop automation via Model Context Protocol. TarsUITarsBridge wraps the UI-TARS desktop automation client as an MCP server with stdio transport, enabling TSG (TarsSecureGuard) gateway to remotely control desktop environments through a standardized protocol. - — evolves separately from TSG gateway - — TSG gateway can mount this bridge automatically via configuration - — speaks standard Model Context Protocol (stdio transport in v0.1.0) - — MVP: stdio transport + 5 tools + mock endpoint ✅ - — HTTP transport dual-mode + official MCP server mount - — TSG gateway auto-include protocol - — Tauri sidecar integration (cross-platform) - — Self-hosted vLLM deployment docs - — 10+ tools, multi-device routing, penetration test report In TSG gateway configuration, enable the bridge:
README
TarsUITarsBridge
MCP Bridge for UI-TARS — connects TSG gateway to UI-TARS desktop automation via Model Context Protocol.
Overview
TarsUITarsBridge wraps the UI-TARS desktop automation client as an MCP server with stdio transport, enabling TSG (TarsSecureGuard) gateway to remotely control desktop environments through a standardized protocol.
- Independent repository — evolves separately from TSG gateway
- Auto-include ready — TSG gateway can mount this bridge automatically via configuration
- MCP-native — speaks standard Model Context Protocol (stdio transport in v0.1.0)
Quick Start
# Install dependencies
npm install
# Build
npm run build
# Run (mock mode if no UI-TARS endpoint configured)
npm start
Configuration
| Environment Variable | Description | Default |
|---|---|---|
UI_TARS_ENDPOINT |
UI-TARS API endpoint URL | (mock mode) |
UI_TARS_API_KEY |
API key for the endpoint | — |
UI_TARS_MODEL |
Model name | ui-tars-1.5-7b |
UI_TARS_TIMEOUT_MS |
Request timeout | 30000 |
MCP Tools (v0.1.0)
| Tool | Description |
|---|---|
screenshot |
Capture screen (PNG/JPEG) |
click |
Click at (x, y) coordinates |
type |
Type text into focused input |
scroll |
Scroll in direction (up/down/left/right) |
browser_open |
Open a URL in the default browser |
Roadmap
- v0.1.0 — MVP: stdio transport + 5 tools + mock endpoint ✅
- v0.2.0 — HTTP transport dual-mode + official MCP server mount
- v0.3.0 — TSG gateway auto-include protocol
- v0.4.0 — Tauri sidecar integration (cross-platform)
- v0.5.0 — Self-hosted vLLM deployment docs
- v1.0.0 — 10+ tools, multi-device routing, penetration test report
Integration with TSG Gateway
In TSG gateway configuration, enable the bridge:
{
"bridges": {
"ui_tars": {
"enabled": true,
"command": "npx tars-ui-tars-bridge",
"env": {
"UI_TARS_ENDPOINT": "http://localhost:8080"
}
}
}
}
License
Apache-2.0 — see LICENSE
Install
This server does not publish a one-line install command.
Open the repository installation guide