Portal

English · 简体中文

Portal es una extensión de VS Code que expone el espacio de trabajo actual como un endpoint MCP público. Es deliberadamente pequeña: solo comandos y transferencia de archivos.

Conecta cualquier cliente MCP (Claude, ChatGPT, Cursor, un agente personalizado, curl) a tu máquina a través de un túnel. El agente puede ejecutar shells y mover archivos. No puede editar texto mediante herramientas MCP — no hay ninguna.

Lo que obtienes

Related MCP server: local-bridge

Herramientas MCP (exactamente cinco)

Shells: powershell (predeterminado en Windows), pwsh, cmd, bash / sh (Git Bash cuando esté presente). UTF-8 se configura automáticamente.

Sesión: reutiliza el Mcp-Session-Id de initialize. Si se pierde o se rechaza, vuelve a ejecutar initialize — no inventes un identificador.

No hay herramientas read_file / write_file / edit_file / list_* / search_files. Lee y escribe con el shell o con la API HTTP de archivos.

Transferencia de archivos (HTTP bidireccional)

El mismo túnel y token que MCP. Tamaño máximo predeterminado: 64 MiB (portal.maxTransferBytes). Las subidas se reemplazan de forma atómica. Las descargas admiten Range y devuelven SHA-256.

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)

Los dominios gratuitos de ngrok requieren el encabezado 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

Proveedores de túnel

El token de ruta es el segmento secreto de la ruta. MCP se encuentra en /mcp/<token>. Deja portal.routeToken vacío para que se genere uno al iniciar.

Comandos (paleta)

• Portal: Iniciar / Detener

• Portal: Copiar URL

• Portal: Comprobar túnel

• Portal: Configuración

• Portal: Instalar cloudflared / Instalar/Actualizar ngrok

• Portal: Mostrar registro / Mostrar la terminal del agente

Ajustes útiles: portal.startOnActivation (activado por defecto), portal.showCommandsInTerminal, portal.localPort (0 = automático, excepto para Cloudflare con nombre).

Compilación

Requiere Node 18+ y 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)

Carga el VSIX empaquetado, o ejecuta la extensión en un host de escritorio de VS Code (extensionKind: ui + workspace).

Licencia

MIT