Skip to main content
Glama
Sign In
deenesjakoruzh
Portal

Portal

by s3hq4y
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

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: FreeRDC Community Edition

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.

Tool Schema Changelog

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

Loading tool schema changelog…

    This server cannot be deployed

    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • AgentBridge

      5258MF
      A
      license
      Not graded
      quality
      B
      maintenance
      Expose your VS Code workspace's tools — files, terminal, LSP, diagnostics, and images — to remote MCP clients over a public HTTPS tunnel.
      7
      MIT

    • FreeRDC Community Edition

      danielarif26
      A
      license
      Not graded
      quality
      B
      maintenance
      Enables a remote MCP client to access narrowly scoped local filesystem resources and process capabilities through a loopback-only bridge. Supports guarded file reads, searches, and mutations, authenticated transport, and private reachability via OpenAI Secure MCP Tunnel.
      1
      AGPL 3.0

    • ReMCP

      getremcp
      A
      license
      A
      quality
      B
      maintenance
      Enables MCP clients to securely work with local files, directories, searches, terminal sessions, and processes on paired computers via outbound connections, without exposing inbound ports.
      7
      4
      MIT