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.

VS Code extension file tools

The extension now provides bounded native text I/O, exact patches, directory pagination and retry-safe chunk uploads. HTTP and MCP share path checks, write locks and publication primitives. See File tools. The duplicated standalone desktop client is not migrated in this change; its file-tool capabilities differ from the extension.

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.
    815 npm
    Apache 2.0
  • 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
  • A
    license
    Not graded
    quality
    A
    maintenance
    Expose your VS Code workspace's tools — files, terminal, LSP, diagnostics, and images — to remote MCP clients over a public HTTPS tunnel.
    2
    MIT