Skip to main content
Glama
s3hq4y
by s3hq4y

Portal

Portal

English · 简体中文

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

client/

Standalone Windows desktop app (Electron + Fluent UI). No VS Code required. Adds native browser-window docking.

Portal (VS Code extension)

vscode-extension/

The original VS Code extension. Full manual: User Guide.

📖 Start with the README of the app you actually want to run:

What you get (both forms)

Surface

Role

MCP Streamable HTTP

https://<tunnel>/mcp/<token>

File HTTP API

https://<tunnel>/files/<token>/… (same token)

Exactly five tools

run_command · start_command · read_command · stop_command · file_transfer_info

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?

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 v3

License

GNU General Public License v3 — GPL-3.0-or-later.

Maintenance

ActivityMaintained
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    A
    maintenance
    Connects 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.
    840
    Apache 2.0
  • A
    license
    Not graded
    quality
    B
    maintenance
    Exposes 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
  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables 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.
    1
    MIT