Portal

English · 简体中文

Portal は、現在のワークスペースを 公開 MCP エンドポイント として公開する VS Code 拡張機能です。意図的に小さく構成されており、コマンドとファイル転送のみです。

任意の MCP クライアント（Claude、ChatGPT、Cursor、カスタムエージェント、curl）をトンネル経由で自分のマシンに接続できます。エージェントはシェルを実行し、ファイルを移動できます。MCP ツールによるテキスト編集はできません — そのようなツールは存在しません。

提供されるもの

Related MCP server: local-bridge

MCP ツール（ちょうど 5 つ）

シェル: powershell（Windows の既定）、pwsh、cmd、bash/sh（Git Bash があればそれ）。UTF-8 は自動設定されます。

セッション: initialize で得られた Mcp-Session-Id を再利用してください。失われた場合や拒否された場合は、もう一度初期化してください — ID をでっち上げないでください。

read_file / write_file / edit_file / list_* / search_files ツールはありません。シェルまたは HTTP ファイル API を使って読み書きしてください。

ファイル転送（双方向 HTTP）

MCP と同じトンネルとトークンを使用します。既定の最大サイズは 64 MiB（portal.maxTransferBytes）。アップロードは原子的に置換されます。ダウンロードは Range をサポートし、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)

無料の ngrok ドメインでは、ヘッダー 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

トンネルプロバイダー

ルートトークンはシークレッ のパスセグメントです。MCP は /mcp/<token> にあります。portal.routeToken を空にすると、起動時に自動生成されます。

コマンド（パレット）

• Portal: 開始 / 停止

• Portal: URL をコピー

• Portal: トンネルを確認

• Portal: 設定

• Portal: cloudflared をインストール / ngrok をインストール / アップグレード

• Portal: ログを表示 / エージェントターミナルを表示

便利な設定: portal.startOnActivation（既定はオン）、portal.showCommandsInTerminal、portal.localPort（0 は自動。名前付き Cloudflare を除く）。

ビルド

Node 18 以上と 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)

パッケージした VSIX を読み込むか、デスクトップ版 VS Code ホストで拡張機能を実行します（extensionKind: ui + workspace）。

ライセンス

MIT