Portal

English · 简体中文

Portal ist eine VS Code-Erweiterung, die den aktuellen Arbeitsbereich als öffentlichen MCP-Endpunkt bereitstellt. Sie ist bewusst klein gehalten: nur Befehle und Dateiübertragung.

Verbinden Sie jeden MCP-Client (Claude, ChatGPT, Cursor, einen benutzerdefinierten Agenten, curl) über einen Tunnel mit Ihrem Rechner. Der Agent kann Shells ausführen und Dateien verschieben. Er kann Text nicht über MCP-Tools bearbeiten – es gibt keine.

Was Sie erhalten

Related MCP server: local-bridge

MCP-Tools (genau fünf)

Shells: powershell (Windows-Standard), pwsh, cmd, bash / sh (Git Bash, wenn vorhanden). UTF-8 wird automatisch eingerichtet.

Sitzung: Verwenden Sie die Mcp-Session-Id aus initialize erneut. Wenn sie verloren geht oder abgelehnt wird, führen Sie initialize erneut aus – erfinden Sie keine ID.

Es gibt keine read_file / write_file / edit_file / list_* / search_files-Tools. Verwenden Sie zum Lesen und Schreiben die Shell oder die HTTP-Datei-API.

Dateiübertragung (bidirektionales HTTP)

Derselbe Tunnel und Token wie bei MCP. Standardmaximalgröße: 64 MiB (portal.maxTransferBytes). Uploads werden atomar ersetzt. Downloads unterstützen Range und geben SHA-256 zurück.

GET    {base}?op=info              capability + workspace
GET    {base}?glob=**/*            list files
GET    {base}/<relpath>            download
HEAD   {base}/<relpath>            metadata
PUT    {base}/<relpath>            upload
DELETE {base}/<relpath>            delete
POST   {base}?op=pack              zip  JSON { "paths": ["src"] }
POST   {base}?op=unpack&dest=.     unzip (raw zip body)

Kostenlose ngrok-Domains benötigen den Header ngrok-skip-browser-warning: 1.

# download
curl -fsSL -H "ngrok-skip-browser-warning: 1" \
  "$BASE/README.md" -o README.md

# upload
curl -fsSL -H "ngrok-skip-browser-warning: 1" \
  -T ./photo.png "$BASE/incoming/photo.png"

# pack a folder
curl -fsSL -H "ngrok-skip-browser-warning: 1" \
  -H "Content-Type: application/json" \
  -d '{"paths":["src"]}' "$BASE?op=pack" -o src.zip

Tunnel-Anbieter

Der Route-Token ist der geheime Pfadbestandteil. MCP befindet sich unter /mcp/<token> stehen. Lassen Sie portal.routeToken leer, um bei jedem Start einen zu generieren.

Befehle (Befehlspalette)

• Portal: Start / Stop

• Portal: Copy URL

• Portal: Check Tunnel

• Portal: Settings

• Portal: Install cloudflared / Install/Upgrade ngrok

• Portal: Show Log / Show Agent Terminal

Nützliche Einstellungen: portal.startOnActivation (standardmäßig aktiviert), portal.showCommandsInTerminal, portal.localPort (0 = automatisch, außer bei benanntem Cloudflare).

Build

Erforderlich sind Node 18+ und VS Code ^1.95.0.

npm install
npm run build      # esbuild → dist/extension.js
npm run typecheck
npm run package    # .vsix (no bundled node_modules)

Laden Sie die gepackte VSIX oder führen Sie die Erweiterung in einem Desktop-VS Code Host aus (extensionKind: ui + workspace).

Lizenz

MIT