Power your agent
The publisher's own command. Not a PlugMCP endpoint.
Host a copy with our keys and logs.
uvx bridge-mcp==2.1.0Claude Code has no install link for a local command. Copy the command below and run it in a terminal.
claude mcp add io.github.barhamagha1-bridge-mcp -- uvx bridge-mcp==2.1.0Run in a terminal.
{ "mcpServers": { "io.github.barhamagha1-bridge-mcp": { "command": "uvx", "args": [ "bridge-mcp==2.1.0" ] } }}claude_desktop_config.json
Remote URL or a command on your machine? How the two installs differ
Run on PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
LaunchGive any AI complete control over your Windows PC
Bridge MCP v2.0 stores agent registrations in a persistent JSON file:
%APPDATA%\bridge-mcp\agents.json~/.config/bridge-mcp/agents.jsonThis means:
cd Bridge-MCP
python local_agent.py
The agent auto-registers itself - no manual registration needed!
Verify in any Claude session:
Use list_agents() to see registered agents
If you see "No agents connected":
check_agent_health() toolregister_agent("local", "http://127.0.0.1:8006", "My PC")For always-on access, install local_agent as a Windows service:
python install_service.py install
python install_service.py start
To remove:
python install_service.py stop
python install_service.py remove
Bridge MCP is a Model Context Protocol (MCP) server that gives any AI full control over a Windows PC. Whether you're using Claude, ChatGPT, Cursor, Gemini, or any other MCP-compatible AI, Bridge MCP lets you:
Think of it as giving your AI eyes and hands to control your computer!
Total: 40+ powerful tools for complete PC automation!
Bridge MCP uses a Relay Architecture to work across platforms:
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Any AI │ │ Cloud Relay │ │ Your Windows │
│ (Claude, etc.) │◄───────►│ (bridge_mcp) │◄───────►│ PC (Agent) │
└─────────────────┘ └─────────────────┘ └─────────────────┘
Bridge MCP 2.0 includes:
agents.json.Powered by Playwright, Bridge MCP can now:
Bridge MCP "sees" your apps:
Bridge MCP now puts YOU in control:
http://localhost:8006See what the AI sees, in real-time:
Bridge MCP now implements the complete Model Context Protocol specification:
Expose desktop data as addressable resources:
desktop://screenshot/latest - Current screenshotdesktop://windows - Open windows listdesktop://logs - Agent command logsfile:///{path} - Read any desktop filedesktop://session/context - Recent session historyPre-built workflow templates for one-click automation:
automate_desktop_task - Step-by-step task automationdebug_error - Interactive error debuggingweb_automation - Playwright web workflowsNever lose context:
git clone https://github.com/BarhamAgha1/Bridge-MCP.git
cd Bridge-MCP
pip install -r requirements-local.txt
Note: Playwright browsers (~100MB) auto-install on first use - no manual setup needed!
python local_agent.py
Keep this terminal open! The agent will display:
Bridge MCP Local Agent running on http://127.0.0.1:8006
See Configuration below for Claude Desktop, Cursor, or VS Code setup.
In your AI conversation, register the local agent:
Use register_agent with:
- agent_id: "my-pc"
- callback_url: "http://127.0.0.1:8006"
- agent_name: "My Windows PC"
Now use any tool like screenshot(), click(100, 200), type_text("Hello"), app_launch("notepad"), etc.
Open the config file at %APPDATA%\Claude\claude_desktop_config.json
Add Bridge MCP:
{
"mcpServers": {
"bridge-mcp": {
"command": "python",
"args": ["C:\\Users\\YourName\\Path\\To\\Bridge-MCP\\bridge_mcp.py"]
}
}
}
⚠️ Important: Replace the path with the actual location where you cloned the repository!
Example paths:
C:\\Users\\PC\\Desktop\\Bridge-MCP\\bridge_mcp.pyD:\\Projects\\Bridge-MCP\\bridge_mcp.pyAdd to your MCP settings in Cursor preferences with the same configuration format.
Create .vscode/mcp.json in your project:
{
"mcpServers": {
"bridge-mcp": {
"command": "python",
"args": ["C:\\Users\\YourName\\Path\\To\\Bridge-MCP\\bridge_mcp.py"]
}
}
}
To control your PC from anywhere, expose the local agent with ngrok:
ngrok http 8006
Then use the ngrok URL (e.g., https://xxxx.ngrok.io) as your callback_url when registering.
User: Open notepad and write "Hello from AI!"
AI uses:
1. app_launch("notepad")
2. wait(1)
3. type_text("Hello from AI!")
User: What's on my screen right now?
AI uses:
1. screenshot()
2. [AI analyzes the image and describes what it sees]
User: Search for "Bridge MCP" on Google
AI uses:
1. chrome_open("https://google.com")
2. type_text("Bridge MCP")
3. press_key("enter")
Check the path - Make sure the path in your config points to the actual bridge_mcp.py file. The path must be absolute and use double backslashes (\\) in JSON.
Test manually - Open Command Prompt and run:
cd "C:\path\to\Bridge-MCP"
python bridge_mcp.py
It should stay running (not exit immediately). Press Ctrl+C to stop.
pip install fastmcp httpx
local_agent.py is running in a terminal (keep it open!)http://127.0.0.1:8006ngrok http 8006) and use the ngrok URLYou need to register your local agent first:
register_agent("my-pc", "http://127.0.0.1:8006", "My PC")
If local_agent.py crashes with Unicode errors, the terminal may not support emojis. This has been fixed in the latest version.
Bridge MCP can be deployed on FastMCP Cloud for easy access:
bridge_mcp.pyYour MCP will be available at: https://your-project.fastmcp.app/mcp
Contributions are welcome! Here's how you can help:
git checkout -b feature/amazing-feature)git commit -m 'Add amazing feature')git push origin feature/amazing-feature)This project is licensed under the MIT License - see the LICENSE file for details.
Barham Agha
⭐ If you find this project useful, please give it a star! ⭐
Made with ❤️ for the AI community
© 2026 MCP Directory.
Visual Desktop Bridge - Give any AI full control over Windows to automate apps and inputs.
{ "mcpServers": { "io.github.barhamagha1-bridge-mcp": { "command": "uvx", "args": [ "bridge-mcp==2.1.0" ] } }}Tools
No tool list yet. Remote servers get one after the first health check.
FAQ
Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.
No required environment variable is listed on this record.
Bridge MCP runs locally over stdio.
Last checked 2026-11-08. Visual Desktop Bridge - Give any AI full control over Windows to automate apps and inputs.