1. Conduid
  2. Developer Tools
  3. UI Bridge MCP
MCP server · Developer Tools

UI Bridge MCP

by · github.com/qontinui/ui-bridge-mcp

Computer Use for Windows - without the screenshots. Element-based MCP server: UIA + Win32 + CDP, 3-tier fallback ladder, ~ms per command.

Unclaimed last commit 7 months ago chrome-devtools-protocolclaudellm-agentsmcpui-automationwindows-automation
InstallView source
47Fair

Scored 14 days ago · breakdown

About UI Bridge MCP

UI Bridge MCP is an MCP server published by qontinui in the Developer Tools category: computer Use for Windows - without the screenshots. Element-based MCP server: UIA + Win32 + CDP, 3-tier fallback ladder, ~ms per command.

The repository has 2 stars and 0 forks, with the last commit 7 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.

Install

From source
git clone https://github.com/qontinui/ui-bridge-mcp

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Tools (1)

ui_healthCheck if qontinui-runner is accessible

Parameters not published.

Ask AI

✦

Ask AI about UI Bridge MCP

Powered by Claude · Grounded in docs

I know everything about UI Bridge MCP. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ✓README presentThe repository ships documentation.
  • !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.

4 checks have not been run yet.

README

UI Bridge MCP

MCP (Model Context Protocol) server for UI Bridge - enables AI to inspect and interact with UI elements.

Overview

This MCP server provides tools for:

  • Inspecting UI elements - Get element positions, bounds, visibility, and state
  • Interacting with elements - Click, type, focus, hover
  • Two modes of operation:
    • Control mode: Interact with the qontinui-runner's own Tauri webview
    • SDK mode: Interact with external apps via the UI Bridge SDK

Installation

# Using pip
pip install ui-bridge-mcp

# Using poetry
poetry add ui-bridge-mcp

Prerequisites

The MCP server requires the qontinui-runner to be running on port 9876.

For external app access, the target application must have the UI Bridge SDK integrated.

Configuration

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "ui-bridge": {
      "command": "ui-bridge-mcp"
    }
  }
}

Claude Code

Add to your MCP settings:

{
  "mcpServers": {
    "ui-bridge": {
      "command": "ui-bridge-mcp"
    }
  }
}

Environment Variables

Variable Default Description
QONTINUI_RUNNER_HOST localhost (or WSL host) Runner hostname
QONTINUI_RUNNER_PORT 9876 Runner port

Available Tools

Health Check

Tool Description
ui_health Check if qontinui-runner is accessible

Control Mode (Runner's Own UI)

Tool Description
ui_snapshot Get complete UI state with all elements
ui_discover Force element discovery/registration
ui_get_element Get detailed info for a specific element
ui_click Click an element by ID
ui_type Type text into an input element
ui_focus Focus an element

SDK Mode (External Apps)

Tool Description
sdk_connect Connect to an SDK-integrated app by URL
sdk_disconnect Disconnect from the current app
sdk_status Check SDK connection status
sdk_elements Get all elements from the connected app
sdk_snapshot Get a full UI snapshot from the connected app
sdk_click Click an element by ID
sdk_type Type into an element by ID

Note: The MCP server also includes legacy extension_* tools for browser tab access via a Chrome extension. These are deprecated and will be removed in a future release. Use the SDK tools instead.

Usage Examples

Inspect Runner UI

AI: Let me check what's on the runner's Settings page.

1. First, get a snapshot of the UI:
   ui_snapshot

2. Click the Settings button:
   ui_click element_id="sidebar-nav-item-settings"

3. Get another snapshot to see the new page:
   ui_snapshot

Inspect an SDK-Integrated App

AI: Let me check the login form on localhost:3000.

1. Connect to the app:
   sdk_connect url="http://localhost:3000"

2. Get all elements:
   sdk_elements

3. Type into the email field:
   sdk_type element_id="email-input" text="test@example.com"

4. Click the submit button:
   sdk_click element_id="login-button"

Element IDs

Elements in the runner's UI have registered IDs that follow patterns like:

  • sidebar-nav-item-{name} - Sidebar navigation items
  • button-{action} - Action buttons
  • input-{field} - Input fields
  • dialog-{name} - Dialog components

Use ui_snapshot to discover all available element IDs.

Architecture

Claude/AI
    |  MCP Protocol
ui-bridge-mcp (this server)
    |  HTTP
qontinui-runner (port 9876)
    |-- /ui-bridge/control/* --> Runner's Tauri webview
    |-- /ui-bridge/sdk/*     --> SDK-integrated apps (direct HTTP)

Development

# Install dependencies
poetry install

# Run linting
poetry run ruff check .
poetry run mypy src

# Format code
poetry run ruff format src

License

MIT

README copy captured when this server was indexed; it may lag the repository. The original is authoritative.

Questions

About UI Bridge MCP

How do I install UI Bridge MCP?

No package has been published for this server, so install it from source: clone the repository and follow its README.

Is UI Bridge MCP safe to use with an AI agent?

Its trust score is 47 out of 100 (fair). It passes 1 of the 2 static security checks run so far; the failures are listed above. It has no ConduID identity yet, so agent calls to it are not receipted.

Is UI Bridge MCP still maintained?

The last commit was 7 months ago. That's long enough that you should check whether the maintainer is responding to issues before depending on it.