Portal
Uses Cloudflare Quick Tunnels or named Cloudflare Tunnels to expose the local MCP endpoint publicly, with either a random trycloudflare.com URL or a fixed hostname.
Uses ngrok reserved domains to expose the local MCP endpoint via a persistent public ngrok URL.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@PortalRunnpm testin the workspace and report the results."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Portal

Portal turns a local folder into a public MCP (Model Context Protocol) endpoint — deliberately minimal: shell commands and file transfer only. Connect any MCP client (Claude, ChatGPT, Cursor, a custom agent, or plain curl) to your machine over a tunnel, run commands, and move files.
The same idea ships in two forms in this repository:
App | Folder | What it is |
Portal Client | Standalone Windows desktop app (Electron + Fluent UI). No VS Code required. Adds native browser-window docking. | |
Portal (VS Code extension) | The original VS Code extension. Full manual: User Guide. |
📖 Start with the README of the app you actually want to run:
Client →
client/README.md· 简体中文Extension →
vscode-extension/README.md· 简体中文
📘 Extension User Guide (install, tunnels, client setup, tool & file-API reference, troubleshooting) →
vscode-extension/USAGE.md· 简体中文
What you get (both forms)
Surface | Role |
MCP Streamable HTTP |
|
File HTTP API |
|
Exactly five tools |
|
Tunnels | ngrok reserved domain · Cloudflare Quick / Named · custom command |
Localized UI | English / 简体中文 |
⚠️ Testing status — Only the ngrok tunnel option has been tested. Cloudflare Quick / Named tunnels and custom tunnel commands are implemented but untested; treat them as experimental and please report anything broken.
Related MCP server: local-bridge
Which one should I use?
No VS Code, want a dedicated app, or want to dock your real browser inside it? →
client/Already live inside VS Code? →
vscode-extension/— then read the User Guide
Both expose the same MCP contract — they are drop-in replacements for each other (and for a single folder, run one of them at a time).
Repository layout
portal/
client/ Portal Client — Electron desktop app (Windows)
vscode-extension/ Portal — VS Code extension (USAGE.md = user guide)
resources/ logos
LICENSE GNU General Public License v3License
GNU General Public License v3 — GPL-3.0-or-later.
This server cannot be deployed
Maintenance
Related MCP Connectors
Secure tunneling, reverse proxy and remote access for local applications.
Run commands and read/write files on your servers over Termalin's keyless tunnels (hosted MCP).
Enable secure connectivity between Sentry issues and debugging data, and LLM clients, using a Model Context Protocol (MCP) server.
Host your MCP tool over streamable HTTP in one command.
Related MCP Servers
- AlicenseNot gradedqualityAmaintenanceEnables cloud agents to securely operate local machine resources (files, commands, screenshots) via standard MCP protocol.MIT
- AlicenseNot gradedqualityAmaintenanceConnects local tools (browser, shell) to a remote MCP server via reverse-MCP, enabling the server agent to control your local browser and execute shell commands.840Apache 2.0
- AlicenseNot gradedqualityBmaintenanceExposes a local development project as a secure MCP server over a stable HTTPS URL via Cloudflare tunnel, with configurable access permissions and 33 development tools for file, command, Git, and process operations.MIT
- AlicenseNot gradedqualityCmaintenanceEnables remote MCP clients like ChatGPT to run shell commands and manage files on your local machine via a Cloudflare tunnel, exposing tools for file operations, search, and task management.1MIT