@markmayandi/bridge 0.0.0-stage → 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +123 -2
- package/bridge-icon.svg +130 -0
- package/bridge.bat +8 -0
- package/bridge.js +897 -0
- package/bridge_icon.png +0 -0
- package/bridge_icon_chatgpt_under10kb.png +0 -0
- package/bridge_logo.jpg +0 -0
- package/package.json +36 -4
- package/secure-folder-mcp/README.md +142 -0
- package/secure-folder-mcp/configure_tunnel.bat +6 -0
- package/secure-folder-mcp/configure_tunnel.ps1 +61 -0
- package/secure-folder-mcp/package.json +26 -0
- package/secure-folder-mcp/server.js +1519 -0
- package/secure-folder-mcp/start-web-bridge.bat +19 -0
- package/secure-folder-mcp/test_client.js +209 -0
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Manimaran
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,3 +1,124 @@
|
|
|
1
|
-
|
|
1
|
+
<div align="center">
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
<img src="./bridge_logo.jpg" alt="Bridge Logo" width="460" style="border-radius: 8px;" />
|
|
4
|
+
|
|
5
|
+
# Bridge
|
|
6
|
+
|
|
7
|
+
**Universal Local-to-Web AI Coding Harness**
|
|
8
|
+
|
|
9
|
+
[](https://www.npmjs.com/package/@manimaran-tech/bridge)
|
|
10
|
+
[](https://opensource.org/licenses/MIT)
|
|
11
|
+
[](https://nodejs.org/)
|
|
12
|
+
[](https://github.com/Manimaran-tech/bridge)
|
|
13
|
+
[](http://makeapullrequest.com)
|
|
14
|
+
|
|
15
|
+
<p align="center">
|
|
16
|
+
Securely connect your local codebases and development environments to Claude Web, ChatGPT, Gemini, and DeepSeek in seconds via the Model Context Protocol (MCP).
|
|
17
|
+
</p>
|
|
18
|
+
|
|
19
|
+
---
|
|
20
|
+
|
|
21
|
+
</div>
|
|
22
|
+
|
|
23
|
+
## Quickstart
|
|
24
|
+
|
|
25
|
+
### 1. Instant Execution (Zero Install)
|
|
26
|
+
|
|
27
|
+
Run directly using `npx`:
|
|
28
|
+
|
|
29
|
+
```bash
|
|
30
|
+
npx @manimaran-tech/bridge
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
### 2. Global Installation
|
|
34
|
+
|
|
35
|
+
Install globally to access the `bridge` command anywhere:
|
|
36
|
+
|
|
37
|
+
```bash
|
|
38
|
+
npm install -g @manimaran-tech/bridge
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
Then navigate to any folder and start:
|
|
42
|
+
|
|
43
|
+
```bash
|
|
44
|
+
bridge .
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
### 3. Clone and Run from Source
|
|
48
|
+
|
|
49
|
+
To inspect the source, customize, or contribute:
|
|
50
|
+
|
|
51
|
+
```bash
|
|
52
|
+
git clone https://github.com/Manimaran-tech/bridge.git
|
|
53
|
+
cd bridge
|
|
54
|
+
node bridge.js
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
Or pass a specific project directory directly:
|
|
58
|
+
|
|
59
|
+
```bash
|
|
60
|
+
node bridge.js /path/to/project
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
---
|
|
64
|
+
|
|
65
|
+
## Universal MCP Connection
|
|
66
|
+
|
|
67
|
+
Bridge automatically creates an Anycast HTTPS tunnel and copies the live endpoint to your clipboard:
|
|
68
|
+
|
|
69
|
+
```text
|
|
70
|
+
https://xxxx.trycloudflare.com/mcp
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
### Connecting to Any AI Client
|
|
74
|
+
|
|
75
|
+
Modern web AI clients (Claude Web, ChatGPT Web, Gemini, and MCP extensions) connect directly using the single `/mcp` URL.
|
|
76
|
+
|
|
77
|
+
1. Copy your live MCP URL from Bridge (automatically placed in your clipboard on startup).
|
|
78
|
+
2. Paste the URL directly into your AI client's MCP or custom tool integration.
|
|
79
|
+
3. Your AI model now has real-time, sandboxed read, write, edit, and terminal test execution capabilities on your local project.
|
|
80
|
+
|
|
81
|
+
No legacy JSON configuration files or manual port forwarding required.
|
|
82
|
+
|
|
83
|
+
---
|
|
84
|
+
|
|
85
|
+
## What Bridge Does
|
|
86
|
+
|
|
87
|
+
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:
|
|
88
|
+
|
|
89
|
+
* **Strict Directory Jail:** AI operations are strictly restricted to the specified project folder with zero parent-directory traversal.
|
|
90
|
+
* **Native Tool Suite:** Exposes native coding tools (`read`, `write`, `edit`, `str_replace_editor`, `pwsh`, `bash`, `jobs`, `plan_mode`).
|
|
91
|
+
* **Zero-Setup Anycast Tunnel:** Public HTTPS tunneling powered by Cloudflare with automatic SSL and clipboard sync.
|
|
92
|
+
* **Terminal Dashboard:** Monospaced LN4 Volt interface with live traffic streaming and real-time directory switching.
|
|
93
|
+
|
|
94
|
+
---
|
|
95
|
+
|
|
96
|
+
## Security Model
|
|
97
|
+
|
|
98
|
+
| Security Vector | Implementation |
|
|
99
|
+
| :--- | :--- |
|
|
100
|
+
| **Path Traversal Protection** | Evaluates canonical `fs.realpathSync`. Access outside the targeted root jail is immediately blocked. |
|
|
101
|
+
| **Symlink Boundary Checks** | Validates symlink resolution. Denies read/write operations targeting locations outside the project folder. |
|
|
102
|
+
| **Local Port Isolation** | Local server binds strictly to `127.0.0.1`. Remote traffic routes through secure single-session Anycast tunnels. |
|
|
103
|
+
| **Live Traffic Audit** | Press `[L]` at any time to stream every incoming JSON-RPC request and tool call in real time. |
|
|
104
|
+
|
|
105
|
+
---
|
|
106
|
+
|
|
107
|
+
## Keyboard Controls
|
|
108
|
+
|
|
109
|
+
| Key | Action |
|
|
110
|
+
| :--- | :--- |
|
|
111
|
+
| `[C]` | Re-copies the active MCP URL to your clipboard. |
|
|
112
|
+
| `[D]` | Opens the In-Terminal Directory Navigator to switch project folders without restarting. |
|
|
113
|
+
| `[L]` | Toggles real-time streaming traffic and tool execution logs. |
|
|
114
|
+
| `[Q]` | Gracefully closes the tunnel, releases ports, and exits. |
|
|
115
|
+
|
|
116
|
+
---
|
|
117
|
+
|
|
118
|
+
## License
|
|
119
|
+
|
|
120
|
+
Distributed under the **MIT License**. See `LICENSE` for details.
|
|
121
|
+
|
|
122
|
+
<div align="center">
|
|
123
|
+
<sub>Maintained by <a href="https://github.com/Manimaran-tech">Manimaran</a></sub>
|
|
124
|
+
</div>
|
package/bridge-icon.svg
ADDED
|
@@ -0,0 +1,130 @@
|
|
|
1
|
+
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" width="100%" height="100%">
|
|
2
|
+
<defs>
|
|
3
|
+
<!-- Background Gradient -->
|
|
4
|
+
<linearGradient id="bgGrad" x1="0%" y1="0%" x2="100%" y2="100%">
|
|
5
|
+
<stop offset="0%" stop-color="#0a0e17" />
|
|
6
|
+
<stop offset="50%" stop-color="#0f172a" />
|
|
7
|
+
<stop offset="100%" stop-color="#05070c" />
|
|
8
|
+
</linearGradient>
|
|
9
|
+
|
|
10
|
+
<!-- Cyan to Violet Gradient for Bridge -->
|
|
11
|
+
<linearGradient id="bridgeBeam" x1="0%" y1="50%" x2="100%" y2="50%">
|
|
12
|
+
<stop offset="0%" stop-color="#00f2fe" />
|
|
13
|
+
<stop offset="50%" stop-color="#4facfe" />
|
|
14
|
+
<stop offset="100%" stop-color="#a855f7" />
|
|
15
|
+
</linearGradient>
|
|
16
|
+
|
|
17
|
+
<!-- Cyan Glow -->
|
|
18
|
+
<linearGradient id="cyanGlow" x1="0%" y1="0%" x2="100%" y2="100%">
|
|
19
|
+
<stop offset="0%" stop-color="#38bdf8" />
|
|
20
|
+
<stop offset="100%" stop-color="#0284c7" />
|
|
21
|
+
</linearGradient>
|
|
22
|
+
|
|
23
|
+
<!-- Purple/AI Spark Glow -->
|
|
24
|
+
<linearGradient id="aiGlow" x1="0%" y1="0%" x2="100%" y2="100%">
|
|
25
|
+
<stop offset="0%" stop-color="#f472b6" />
|
|
26
|
+
<stop offset="50%" stop-color="#c084fc" />
|
|
27
|
+
<stop offset="100%" stop-color="#818cf8" />
|
|
28
|
+
</linearGradient>
|
|
29
|
+
|
|
30
|
+
<!-- Filters for Bloom/Glow -->
|
|
31
|
+
<filter id="glowEffect" x="-20%" y="-20%" width="140%" height="140%">
|
|
32
|
+
<feGaussianBlur stdDeviation="10" result="blur" />
|
|
33
|
+
<feComposite in="SourceGraphic" in2="blur" operator="over" />
|
|
34
|
+
</filter>
|
|
35
|
+
|
|
36
|
+
<filter id="softGlow" x="-30%" y="-30%" width="160%" height="160%">
|
|
37
|
+
<feGaussianBlur stdDeviation="22" result="blur" />
|
|
38
|
+
<feComposite in="SourceGraphic" in2="blur" operator="over" />
|
|
39
|
+
</filter>
|
|
40
|
+
</defs>
|
|
41
|
+
|
|
42
|
+
<!-- Base Rounded Icon Container -->
|
|
43
|
+
<rect width="512" height="512" rx="112" fill="url(#bgGrad)" stroke="#1e293b" stroke-width="3" />
|
|
44
|
+
|
|
45
|
+
<!-- Subtle Ambient Glow Orbs in Background -->
|
|
46
|
+
<circle cx="160" cy="256" r="110" fill="#0284c7" opacity="0.12" filter="url(#softGlow)" />
|
|
47
|
+
<circle cx="352" cy="256" r="110" fill="#a855f7" opacity="0.15" filter="url(#softGlow)" />
|
|
48
|
+
|
|
49
|
+
<!-- Ambient Grid / Network Lines (Subtle) -->
|
|
50
|
+
<g stroke="#334155" stroke-width="1.2" opacity="0.25">
|
|
51
|
+
<line x1="80" y1="180" x2="432" y2="180" stroke-dasharray="6,6" />
|
|
52
|
+
<line x1="80" y1="256" x2="432" y2="256" stroke-dasharray="4,4" />
|
|
53
|
+
<line x1="80" y1="332" x2="432" y2="332" stroke-dasharray="6,6" />
|
|
54
|
+
<line x1="160" y1="100" x2="160" y2="412" stroke-dasharray="6,6" />
|
|
55
|
+
<line x1="256" y1="100" x2="256" y2="412" stroke-dasharray="4,4" />
|
|
56
|
+
<line x1="352" y1="100" x2="352" y2="412" stroke-dasharray="6,6" />
|
|
57
|
+
</g>
|
|
58
|
+
|
|
59
|
+
<!-- Left Pillar / Local Terminal Bracket -->
|
|
60
|
+
<g filter="url(#glowEffect)">
|
|
61
|
+
<!-- Local Terminal Chassis -->
|
|
62
|
+
<path d="M 190 160 L 135 160 C 120 160 110 170 110 185 L 110 327 C 110 342 120 352 135 352 L 190 352"
|
|
63
|
+
fill="none" stroke="url(#cyanGlow)" stroke-width="14" stroke-linecap="round" stroke-linejoin="round" />
|
|
64
|
+
|
|
65
|
+
<!-- Local Code / Drive Nodes -->
|
|
66
|
+
<circle cx="110" cy="220" r="6" fill="#38bdf8" />
|
|
67
|
+
<circle cx="110" cy="256" r="8" fill="#00f2fe" />
|
|
68
|
+
<circle cx="110" cy="292" r="6" fill="#38bdf8" />
|
|
69
|
+
|
|
70
|
+
<!-- Terminal Prompt Icon `>_` inside local zone -->
|
|
71
|
+
<path d="M 135 238 L 155 256 L 135 274" fill="none" stroke="#00f2fe" stroke-width="7" stroke-linecap="round" stroke-linejoin="round" />
|
|
72
|
+
<line x1="165" y1="274" x2="180" y2="274" stroke="#00f2fe" stroke-width="7" stroke-linecap="round" />
|
|
73
|
+
</g>
|
|
74
|
+
|
|
75
|
+
<!-- Right Pillar / Cloud AI Spark Constellation -->
|
|
76
|
+
<g filter="url(#glowEffect)">
|
|
77
|
+
<!-- Web AI Star / Spark Shape -->
|
|
78
|
+
<path d="M 370 160 L 425 160 C 440 160 450 170 450 185 L 450 327 C 450 342 440 352 425 352 L 370 352"
|
|
79
|
+
fill="none" stroke="url(#aiGlow)" stroke-width="14" stroke-linecap="round" stroke-linejoin="round" />
|
|
80
|
+
|
|
81
|
+
<!-- AI Starburst Core -->
|
|
82
|
+
<g transform="translate(370, 256)">
|
|
83
|
+
<!-- 4-point Diamond Star -->
|
|
84
|
+
<path d="M 0 -42 C 0 -10 10 0 42 0 C 10 0 0 10 0 42 C 0 10 -10 0 -42 0 C -10 0 0 -10 0 -42 Z"
|
|
85
|
+
fill="url(#aiGlow)" />
|
|
86
|
+
<!-- Star Center Core -->
|
|
87
|
+
<circle cx="0" cy="0" r="9" fill="#ffffff" />
|
|
88
|
+
</g>
|
|
89
|
+
|
|
90
|
+
<circle cx="450" cy="220" r="6" fill="#f472b6" />
|
|
91
|
+
<circle cx="450" cy="256" r="8" fill="#c084fc" />
|
|
92
|
+
<circle cx="450" cy="292" r="6" fill="#818cf8" />
|
|
93
|
+
</g>
|
|
94
|
+
|
|
95
|
+
<!-- THE BRIDGE (Central Hyper-Beam Arch) -->
|
|
96
|
+
<g filter="url(#glowEffect)">
|
|
97
|
+
<!-- Outer Quantum Arc (Upper) -->
|
|
98
|
+
<path d="M 180 215 C 225 165 287 165 332 215"
|
|
99
|
+
fill="none" stroke="url(#bridgeBeam)" stroke-width="9" stroke-linecap="round" opacity="0.85" />
|
|
100
|
+
|
|
101
|
+
<!-- Main High-Speed Quantum Highway (Center) -->
|
|
102
|
+
<path d="M 185 256 L 327 256"
|
|
103
|
+
fill="none" stroke="url(#bridgeBeam)" stroke-width="16" stroke-linecap="round" />
|
|
104
|
+
|
|
105
|
+
<!-- White Inner Core Beam for intense laser brightness -->
|
|
106
|
+
<path d="M 200 256 L 312 256"
|
|
107
|
+
fill="none" stroke="#ffffff" stroke-width="5" stroke-linecap="round" opacity="0.95" />
|
|
108
|
+
|
|
109
|
+
<!-- Outer Quantum Arc (Lower) -->
|
|
110
|
+
<path d="M 180 297 C 225 347 287 347 332 297"
|
|
111
|
+
fill="none" stroke="url(#bridgeBeam)" stroke-width="9" stroke-linecap="round" opacity="0.85" />
|
|
112
|
+
</g>
|
|
113
|
+
|
|
114
|
+
<!-- Central Nexus Portal (Where Local meets LLM) -->
|
|
115
|
+
<g transform="translate(256, 256)" filter="url(#glowEffect)">
|
|
116
|
+
<circle cx="0" cy="0" r="24" fill="#0f172a" stroke="url(#bridgeBeam)" stroke-width="6" />
|
|
117
|
+
<circle cx="0" cy="0" r="10" fill="#ffffff" />
|
|
118
|
+
<!-- Dynamic Packet Pulses -->
|
|
119
|
+
<circle cx="-38" cy="0" r="5" fill="#00f2fe" />
|
|
120
|
+
<circle cx="38" cy="0" r="5" fill="#f472b6" />
|
|
121
|
+
</g>
|
|
122
|
+
|
|
123
|
+
<!-- Subtitle Text "BRIDGE" (Tech Monospace) -->
|
|
124
|
+
<text x="256" y="420" text-anchor="middle" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'JetBrains Mono', monospace" font-size="28" font-weight="800" letter-spacing="8" fill="#e2e8f0" opacity="0.9">
|
|
125
|
+
BRIDGE
|
|
126
|
+
</text>
|
|
127
|
+
<text x="256" y="445" text-anchor="middle" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif" font-size="13" font-weight="600" letter-spacing="3" fill="#64748b">
|
|
128
|
+
LOCAL ↔ WEB AI HARNESS
|
|
129
|
+
</text>
|
|
130
|
+
</svg>
|
package/bridge.bat
ADDED
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
@echo off
|
|
2
|
+
title Bridge - Universal Local-to-Web AI Harness
|
|
3
|
+
reg add "HKCU\Console\Bridge - Universal Local-to-Web AI Harness" /v FaceName /t REG_SZ /d "Courier New" /f >nul 2>&1
|
|
4
|
+
reg add "HKCU\Console\Bridge - Universal Local-to-Web AI Harness" /v FontSize /t REG_DWORD /d 0x00120000 /f >nul 2>&1
|
|
5
|
+
cd /d "%~dp0"
|
|
6
|
+
node bridge.js --launch %*
|
|
7
|
+
echo.
|
|
8
|
+
pause
|