HJ

hp-jh/tarsuitarsbridge

Developer tools
0 stars 0 forks Quality 69 Trend 20Apache-2.0

MCP 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

View this README on GitHub

Install

This server does not publish a one-line install command.

Open the repository installation guide