Skip to main content
Glama
deenesjakoruzh
s3hq4y

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: Remote Coding Runtime

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.

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

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • AgentBridge

    5258MF
    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.
    5
    MIT

  • Remote Coding Runtime

    aloneio
    F
    license
    Not graded
    quality
    A
    maintenance
    Enables MCP clients to safely access user-local filesystems, apply validated patches, inspect git state, and run persistent jobs on outbound-connected local runners through a stateless Cloudflare control plane.
    16
    -

  • 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
    A
    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.
    2
    7
    1
    MIT