Portal

English · 简体中文

Portal — это расширение VS Code, которое представляет текущее рабочее пространство как публичный MCP-эндпоинт. Оно намеренно минималистично: только команды и передача файлов.

Что вы получаете

Related MCP server: local-bridge

Инструменты MCP (ровно пять)

Командные оболочки: powershell (по умолчанию в Windows), pwsh, cmd, bash / sh (Git Bash при наличии). UTF-8 настраивается автоматически.

Сессии — повторно используйте Mcp-Session-Id из initialize. Если он потерян или отклонён, снова выполните initialize — не изобретайте собственный ID.

Здесь нет инструментов read_file / write_file / edit_file / list_* / search_files. Читать и записывать можно через оболочку или HTTP-интерфейс файлов.

Передача файлов (двунаправленный HTTP)

Тот же туннель и токен, что и для MCP. Максимальный размер по умолчанию: 64 МиБ (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