Vibie Mcp

io.github.shdomi8599由 GitHub 帳號 shdomi8599 發布v0.2.2更新於 Oct 24, 2026

Deploy HTML folders to vibie.page from Claude / Cursor — one-line install, OAuth, auto-update.

已驗證STDIO僅桌面雲端與基礎設施開發者工具

概覽

AI 產生的概覽

將本機 HTML 資料夾或單一 HTML 檔案部署到永久的 *.vibie.page 公開網址，可從 MCP 用戶端完成。

可以做什麼
此伺服器提供把靜態網頁內容發佈到 Vibie 代管服務的工具。vibie_create_site 會上傳資料夾並建立新網站，回傳公開網址，並寫入 .vibie/site.json 標記，讓後續更新指向同一個網站。vibie_update_site 會把內容重新部署到既有網站，vibie_list_sites 與 vibie_get_site 則讀取帳號下的網站清單與中繼資料。隱藏檔案與 node_modules 會被略過，單一 HTML 檔案上傳時會自動改名為 index.html。
適用情境
當你希望助理直接從本機專案資料夾發佈靜態網站或單一 HTML 頁面並取得可分享的連結，之後再把修改推送到同一個網址而不必手動上傳時，適合使用。
執行需求
以 stdio 在本機執行，通常透過 npx 啟動，因此需要 Node.js 與網路存取。首次使用會觸發 OAuth 2.0 裝置授權：在瀏覽器開啟連結、以 Google 登入並同意授權；權杖儲存在 ~/.vibie/credentials.json。可選變數 VIBIE_API_BASE 可覆寫 API 位址。
安裝前請注意
此伺服器會把所選資料夾的內容上傳到 Vibie 的伺服器，因此該資料夾中的內容會以 *.vibie.page 網址公開；隱藏檔案與 node_modules 會被略過，但其他檔案不會被過濾。它會在部署資料夾中寫入 .vibie/site.json，並把 OAuth 權杖儲存在 ~/.vibie/credentials.json，可在 Vibie 帳號設定中撤銷。上傳限制為每個網站 100 MB、500 個檔案、單一檔案 25 MB。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Vibie Mcp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

vibie-mcp

MCP server for Vibie — deploy static folders to permanent *.vibie.page URLs from Claude Desktop / Cursor / any MCP-compatible client.

Install

One-line auto setup (recommended)

sh
npx vibie-mcp setup

Auto-detects Claude Desktop (Windows Store + APPDATA / macOS / Linux) and Cursor (~/.cursor/mcp.json) configs, then adds the vibie entry. Restart the client and you're done.

Manual config

If auto setup doesn't fit your client, add this to your MCP config (claude_desktop_config.json, ~/.cursor/mcp.json, etc.):

json
{  "mcpServers": {    "vibie": {      "command": "npx",      "args": ["-y", "vibie-mcp"]    }  }}

After saving, fully quit and restart your client.

First-time auth

On first tool call, the server initiates an OAuth 2.0 Device Authorization Grant. Your AI will receive instructions like:

Please open https://vibie.io/device?code=XXXX-YYYY in a browser, sign in with Google, and click Authorize. Then ask me to try again.

After authorizing in the browser, ask your AI to retry the same request. The server stores a token in ~/.vibie/credentials.json (chmod 0600) and reuses it for future calls.

You can revoke the token anytime at https://vibie.io/settings/api.

Tools

  • vibie_create_site — Upload a folder and create a new Vibie site. Auto-writes .vibie/site.json in the folder so future updates use the same site.
  • vibie_update_site — Re-deploy to an existing site. Reads slug from .vibie/site.json if not specified.
  • vibie_list_sites — List sites under your account.
  • vibie_get_site — Metadata for one site by slug.

How AI typically uses it

You: "Deploy this folder to vibie"AI: → vibie_create_site({ folder: "." })    → Returns: https://my-folder-x7f2.vibie.page
You: "Push my changes"AI: Detects .vibie/site.json    → vibie_update_site({ folder: "." })    → Same URL, new content

Folder structure

What gets uploaded from a folder:

  • index.html + style.css + js/, assets/, etc — all included
  • Hidden files (.git, .vibie, .DS_Store) — automatically skipped
  • node_modules/ — skipped
  • Limits: 100 MB per site, 500 files per upload, 25 MB per file (Vibie's server validates)

A single HTML file (any name) also works — it gets auto-renamed to index.html on upload.

Env

VariableDefaultPurpose
VIBIE_API_BASEhttps://vibie.ioOverride for local dev (http://localhost:3000)

License

MIT

來源：README.md，提交 47e3e72

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.2.2最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分