# BridgeCommander

**Sovereign MCP desktop control server** — reliable, hardened replacement for Desktop Commander.

- Zero blocking network calls on initialize
- Hard session + buffer + concurrency limits
- Never uses `shell: true`
- Dual-ready (stdio + future HTTP)
- Emits events for Bridge Brain / theBRIDGE flywheel
- Works with any MCP client (Claude Desktop, Cursor, Windsurf, VS Code, etc.)

## Quick Start

```bash
git clone https://github.com/copperlang2007/bridge-commander.git
cd bridge-commander
bash ONE-CLICK.sh
```

Then:

```bash
node bin/cli.js setup
```

Paste the printed JSON into your MCP client config and restart the client.

### Claude Desktop
`~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)  
`%APPDATA%\Claude\claude_desktop_config.json` (Windows)

### Cursor
`~/.cursor/mcp.json`

## One-Command Local Run

```bash
npm install
npx tsx src/server.ts
```

## Environment Variables

| Variable | Default | Description |
|----------|---------|-------------|
| `BRIDGE_COMMANDER_ROOTS` | `process.cwd()` | Comma-separated allowed roots |
| `BRIDGE_MAX_SESSIONS` | `12` | Max concurrent processes |
| `BRIDGE_BRAIN_URL` | — | Optional POST endpoint for outcome events |
| `BRIDGE_HTTP` | — | Set to `1` for future HTTP mode |

## Security Notes

- All paths are restricted to the configured roots
- Commands are never executed through a shell
- Output buffers are hard-capped
- Sessions are automatically reaped after idle timeout

## License

MIT