🖥️ Desktop Commander MCP

Give ChatGPT a controlled bridge to your Windows computer through the Model Context Protocol (MCP).

Desktop Commander is a Python MCP server for ChatGPT. It exposes tools for local files, folders, processes, Windows automation, a dedicated Chrome browser session, web-page interaction, and API inspection. An ngrok HTTPS tunnel lets ChatGPT connect to the server running on your PC.

✨ Capabilities

Related MCP server: ChatGPT Codex Bridge

🧱 Architecture

flowchart LR
    C["ChatGPT"] -->|"HTTPS / MCP"| N["ngrok tunnel"]
    N -->|"http://127.0.0.1:8000"| M["Desktop Commander\nFastMCP server"]
    M --> F["Files & folders"]
    M --> W["Windows & processes"]
    M --> B["Dedicated MCP Chrome profile"]

The server uses Streamable HTTP and serves its MCP endpoint at the root path (/). In ChatGPT, enter the ngrok HTTPS URL exactly as shown—do not append /mcp.

🧰 Tech stack

• Python 3.13+ — runtime

• MCP Python SDK / FastMCP 1.x — MCP server and Streamable HTTP transport

• ngrok — public HTTPS tunnel to the local server

• Selenium + ChromeDriver — browser control and page automation

• PyAutoGUI + PyGetWindow — Windows desktop interaction

• psutil + requests — process/system information and API calls

🚀 Quick start

1. Clone the project

git clone https://github.com/kathirm1323-ai/MCP.git
cd MCP

2. Create a Python environment and install dependencies

py -3.13 -m venv venv
.\venv\Scripts\Activate.ps1
pip install -r requirements.txt

3. Install and authenticate ngrok

Install ngrok from ngrok.com, sign in, then add the authtoken from your ngrok dashboard:

ngrok config add-authtoken YOUR_NGROK_AUTHTOKEN

4. Start the MCP server

Double-click start_mcp.bat.

The script starts the local MCP server on port 8000, waits for it to boot, and then starts ngrok. Keep the two command windows open while you use the connector.

5. Connect it to ChatGPT

1. Copy the Forwarding https://... address displayed by ngrok.

2. In ChatGPT, open Settings → Apps → Create new connector.

3. Paste the HTTPS address directly. Do not add /mcp.

4. Choose No authentication and create the connector.

5. Start a new chat and enable your Desktop Commander connector.

🔁 Typical workflow

Start start_mcp.bat
        ↓
Copy ngrok's HTTPS forwarding URL
        ↓
Create or update the ChatGPT connector
        ↓
Ask ChatGPT to use Desktop Commander
        ↓
ChatGPT calls a tool → ngrok → your local MCP server → result in ChatGPT

Example prompts:

Use Desktop Commander to list files in C:\Users\kathi\Documents.

Use Desktop Commander to open https://github.com in Chrome.

Use Desktop Commander to take a screenshot and tell me which windows are open.

🧩 Tool reference

🌐 Chrome behavior

Chrome automation uses a dedicated MCP Chrome profile with remote debugging enabled. This avoids disturbing your usual Chrome tabs, windows, or signed-in profile.

The first time you use a Chrome tool, a separate Chrome window may open. Sign in to websites such as GitHub in that MCP-controlled window when needed.

🔗 Permanent ngrok URL (optional)

By default, ngrok creates a temporary HTTPS URL that changes after each restart. To keep a permanent ChatGPT connector URL:

1. Reserve a domain in the ngrok dashboard.

2. Open start_mcp.bat.

3. Set NGROK_DOMAIN to the reserved hostname:

set "NGROK_DOMAIN=your-domain.ngrok-free.app"

The domain must belong to the same ngrok account as your configured authtoken.

📂 Project structure

MCP/
├── server.py            # FastMCP server and tool implementations
├── start_mcp.bat        # Starts the server and ngrok tunnel
├── stop_mcp.bat         # Stops the server and tunnel
├── status_mcp.bat       # Checks server/tunnel status
├── tray_icon.py         # Optional system-tray controller
├── autostart_mcp.bat    # Optional Windows startup launcher
├── run_hidden.vbs       # Optional hidden launcher
├── requirements.txt     # Python dependencies
└── HOW_IT_WORKS.md      # More implementation detail

🔒 Security notes

This server can read and change files, run commands, control apps, and interact with websites on your PC. Treat its ngrok URL like a password.

• Connect it only to a ChatGPT account you control.

• Do not share the ngrok URL publicly.

• Stop the server when you are not using it with stop_mcp.bat.

• Review tool requests carefully before approving actions that delete files, run commands, or submit web forms.

• The connector is configured with No authentication; the ngrok URL is therefore the access boundary.

🛠️ Troubleshooting

📄 License

MIT