Skip to main content
Glama

Bridge

Universal Local-to-Web AI Coding Harness

npm version License: MIT Node.js Platform PRs Welcome


Quickstart

1. Instant Execution (Zero Install)

Run directly using npx:

npx @markmayandi/bridge

2. Global Installation

Install globally to access the bridge command anywhere:

npm install -g @markmayandi/bridge

Then navigate to any folder and start:

bridge .

3. Clone and Run from Source

To inspect the source, customize, or contribute:

git clone https://github.com/Manimaran-tech/bridge.git
cd bridge
node bridge.js

Or pass a specific project directory directly:

node bridge.js /path/to/project

Related MCP server: Local-MCP-Bridge

Universal MCP Connection

Bridge automatically creates an Anycast HTTPS tunnel and copies the live endpoint to your clipboard:

https://xxxx.trycloudflare.com/mcp

Connecting to Any AI Client

Modern web AI clients (Claude Web, ChatGPT Web, Gemini, and MCP extensions) connect directly using the single /mcp URL.

  1. Copy your live MCP URL from Bridge (automatically placed in your clipboard on startup).

  2. Paste the URL directly into your AI client's MCP or custom tool integration.

  3. Your AI model now has real-time, sandboxed read, write, edit, and terminal test execution capabilities on your local project.

No legacy JSON configuration files or manual port forwarding required.


What Bridge Does

Cloud-based AI models cannot safely access files on your physical machine without open ports or copy-pasting code snippets. Bridge solves this with a high-performance local daemon:

  • Strict Directory Jail: AI operations are strictly restricted to the specified project folder with zero parent-directory traversal.

  • Native Tool Suite: Exposes native coding tools (read, write, edit, str_replace_editor, pwsh, bash, jobs, plan_mode).

  • Zero-Setup Anycast Tunnel: Public HTTPS tunneling powered by Cloudflare with automatic SSL and clipboard sync.

  • Terminal Dashboard: Monospaced LN4 Volt interface with live traffic streaming and real-time directory switching.


Security Model

Security Vector

Implementation

Path Traversal Protection

Evaluates canonical fs.realpathSync. Access outside the targeted root jail is immediately blocked.

Symlink Boundary Checks

Validates symlink resolution. Denies read/write operations targeting locations outside the project folder.

Local Port Isolation

Local server binds strictly to 127.0.0.1. Remote traffic routes through secure single-session Anycast tunnels.

Live Traffic Audit

Press [L] at any time to stream every incoming JSON-RPC request and tool call in real time.


Keyboard Controls

Key

Action

[C]

Re-copies the active MCP URL to your clipboard.

[D]

Opens the In-Terminal Directory Navigator to switch project folders without restarting.

[L]

Toggles real-time streaming traffic and tool execution logs.

[Q]

Gracefully closes the tunnel, releases ports, and exits.


License

Distributed under the MIT License. See LICENSE for details.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Connects MCP-compatible AI clients and agents to one durable Project Brain plus controlled access to authorized project folders on your own machine. Enables file editing, terminal and Git operations, project intelligence, browser automation, and local MCP server federation, all scoped to explicit workspace grants.
      Apache 2.0
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables AI assistants to securely inspect, search, edit, build, and test explicitly authorized local development projects over MCP, with sandboxed filesystem access and sensitive-file protection.
      2
      AGPL 3.0