# Bridge MCP

Bridge MCP connects an AI agent to a Windows desktop so it can operate apps, interact with the screen and automate Chrome. Use it to hand desktop tasks to an agent.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6
- Author: BarhamAgha1
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/BarhamAgha1/Bridge-MCP
- Updated: 2026-01-20
- HTML: https://affpapa.org/en/nevibecode/mcp/bridge-mcp

## What it does

The MCP server relays requests to a local Windows agent. An AI client can launch or switch apps, use the mouse and keyboard, inspect interface elements, capture the screen and control Chrome. Browser workflows use Playwright, whose browsers are installed on first use.

The local agent needs Python 3.10+ and the packages listed in `requirements-local.txt`. Start it with `python local_agent.py` and keep the terminal open; it listens on port 8006. Risky actions, including file writes and shell-script execution, are blocked unless approved. Choosing to approve every future command turns Safe Mode off, so the agent then has fewer approval checks.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add bridge-mcp -- uvx bridge-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from bridge-mcp <command>

### Codex

**Platform CLI**
```bash
codex mcp add bridge-mcp -- uvx bridge-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from bridge-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "bridge-mcp": {
            "command": "uvx",
            "args": [
                "bridge-mcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from bridge-mcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "bridge-mcp": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "bridge-mcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from bridge-mcp <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add bridge-mcp uvx bridge-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from bridge-mcp <command>

## When to use it
- control application windows through an AI client
- click interface elements and enter text on Windows
- capture the desktop and inspect UI elements
- automate Chrome browsing tasks
- run PowerShell commands and handle files

## Example prompts
- Open the settings window in the requested app.
- Find the submit button on this page and click it.
- List the open windows and capture a screenshot.

## Similar
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89899
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [AIHawk](https://affpapa.org/en/nevibecode/mcp/aihawk.md) — MCP server · ★ 32260
- [Skyvern](https://affpapa.org/en/nevibecode/mcp/skyvern.md) — MCP server · ★ 23283
- [SeleniumBase MCP](https://affpapa.org/en/nevibecode/mcp/seleniumbase-mcp.md) — MCP server · ★ 13181
- [Inbox Zero](https://affpapa.org/en/nevibecode/mcp/inbox-zero.md) — MCP server · ★ 12826

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md