AgentStack
Browse Sign in
Browse Why AgentStack Sell Docs
Sign in
MCP verified MIT Self-run

Bridgedesk

mcp-stanic-mah-bridgedesk · by stanic-mah

Let ChatGPT read, edit, search, and run on real local files and projects on your computer.

↗ Website ↗ Repository
— No reviews yet
0 installs
14 views
0.0% view→install

Install

$ agentstack add mcp-stanic-mah-bridgedesk

✓ scanned · ✓ verified, works with Claude Code, Cursor, and more.

Security review

✓ Passed

No issues found. Passed automated security review. · v0.1.0 How review works →

  • ✓ Prompt-injection patterns
  • ✓ Secret / credential exfiltration
  • ✓ Dangerous shell & filesystem operations
  • ✓ Untrusted network calls
  • ✓ Known-malicious package signatures

What it can access

  • ✓ Network access No
  • ✓ Filesystem access No
  • ✓ Shell / process execution No
  • ✓ Environment & secrets No
  • ✓ Dynamic code execution No

From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.

View the full security report →

Verified badge

Passed review? Show it. Paste this badge into your README, it links to the public security report.

AgentStack Verified badge Links to your public security report.
[![AgentStack Verified](https://agentstack.voostack.com/badges/verified.svg)](https://agentstack.voostack.com/security/report/mcp-stanic-mah-bridgedesk)

Reliability & compatibility

✓ Security review passed
0 installs to date
— no reviews yet
● 1mo ago

Declared compatibility

Claude CodeClaude DesktopCursorWindsurf

Compatibility is declared by the source manifest. End-to-end runtime verification is coming, see below.

Preview Execution monitoring

We're building live execution health for every listing: tool-call success rate, median latency, uptime, and last-checked timestamps, measured, not self-reported. It isn't live yet, so we don't show numbers we can't stand behind.

How agent discovery & health will work →
Are you the author of Bridgedesk? Claim this listing to set pricing, connect Stripe payouts, and keep 70% of every sale.
Sign up to claim

About

BridgeDesk

About

BridgeDesk is a desktop launcher and local MCP workspace server for ChatGPT and other MCP clients. It lets a trusted MCP client work with selected local project folders through explicit tools for reading, editing, searching, running commands, and showing changes.

BridgeDesk is Windows-first. It is designed for local development workflows where you choose one approved project folder, start the BridgeDesk server, and connect an MCP-capable client through the generated MCP URL.

Download BridgeDesk

For normal Windows use, download the latest installer from GitHub Releases:

https://github.com/stanic-mah/bridgedesk/releases/latest/download/BridgeDesk-Setup.exe

The installer build supports BridgeDesk's in-app update checks. A portable exe is also attached to each release for manual use, but the installer is the recommended download.

BridgeDesk has two entrypoints:

  • an Electron desktop launcher for setup, tunnels, process control, and copyable

connection details

  • a CLI and MCP server for headless or scripted use

Requirements

  • Node >=20.12 <27
  • npm
  • Git
  • Bash-compatible shell; Git Bash is the simplest Windows option
  • Optional: cloudflared for the launcher-managed quick tunnel

Desktop Launcher

Install dependencies and start the launcher from a local checkout:

npm install
npm run desktop

The launcher checks local requirements, lets you choose one project folder, starts a Cloudflare tunnel when available, starts the BridgeDesk server, and copies the MCP URL and Owner password for the MCP client.

BridgeDesk supports two tunnel modes:

  • Quick Tunnel: easiest setup. Cloudflare gives BridgeDesk a temporary

trycloudflare.com URL, and that URL changes when the tunnel is restarted.

  • Permanent Tunnel: best for regular use. BridgeDesk uses your Cloudflare

account, domain, and named tunnel so the MCP URL can stay fixed, for example https://mcp.yourdomain.com/mcp.

Use Permanent Tunnel if you do not want to re-add the MCP server in ChatGPT after closing the app or restarting the computer.

For step-by-step setup, including Cloudflare Tunnel installation, Permanent Tunnel setup, ChatGPT connection, and troubleshooting, see [docs/user-guide.md](docs/user-guide.md).

Important Cloudflare note: if ChatGPT fails after you enter the BridgeDesk owner password, turn off Cloudflare Bot Fight Mode for the BridgeDesk domain. Bot Fight Mode can block ChatGPT's OAuth requests before they reach BridgeDesk.

If Cloudflare Tunnel is not installed, paste any HTTPS tunnel URL into the launcher. The URL should point to:

http://127.0.0.1:7676

Use this MCP endpoint in the client:

https://your-tunnel-host.example.com/mcp

CLI

Build and run locally:

npm install
npm run build
node dist/cli.js init
node dist/cli.js serve

After publishing or linking the package, the public command is:

bridgedesk init
bridgedesk serve
bridgedesk doctor
bridgedesk config get
bridgedesk config set publicBaseUrl https://your-tunnel-host.example.com

The default local endpoint is:

http://127.0.0.1:7676/mcp

Configuration

BridgeDesk stores local configuration in:

~/.bridgedesk/config.json
~/.bridgedesk/auth.json

Important environment variables:

  • BRIDGEDESK_PUBLIC_BASE_URL
  • BRIDGEDESK_ALLOWED_ROOTS
  • BRIDGEDESK_OAUTH_OWNER_TOKEN
  • BRIDGEDESK_STATE_DIR
  • BRIDGEDESK_WORKTREE_ROOT
  • BRIDGEDESK_TOOL_MODE

See [docs/configuration.md](docs/configuration.md) for the full reference.

Security

BridgeDesk is powerful local access to selected folders on your machine. Keep allowed roots narrow, protect auth.json, and connect only trusted MCP clients. The desktop launcher rejects drive roots and the whole user folder as project roots.

See [docs/security.md](docs/security.md) for the full model.

Development

npm install
npm run typecheck
npm test
npm run build
npm run desktop

The build produces:

  • dist/cli.js for the CLI
  • dist/server.js for the MCP server
  • dist/ui for MCP app widgets
  • dist/desktop for the Electron launcher

License

BridgeDesk is distributed under the MIT License. See [LICENSE](LICENSE).

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

Install and usage instructions live in the source repository linked above.

Reviews

No reviews yet, be the first.

Write a review

Versions

  • v0.1.0 Imported from the upstream source.

More in Search