vibie-mcp

vibie-mcp

Claude Desktop / Cursor / 任意の MCP 対応クライアントから、静的フォルダーを永続的な *.vibie.page URL にデプロイする Vibie 用 MCP サーバーです。

インストール

1 行で自動セットアップ（推奨）

npx vibie-mcp setup

Claude Desktop（Windows Store ＋ APPDATA / macOS / Linux）および Cursor（~/.cursor/mcp.json）の設定を自動検出し、vibie エントリを追加します。クライアントを再起動すれば完了です。

手動設定

自動セットアップがクライアントに適さない場合は、MCP 設定（claude_desktop_config.json、~/.cursor/mcp.json など）に以下を追加します。

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

保存したら、クライアントを完全に終了してから再起動してください。

初回認証

最初のツール呼び出し時に、サーバーが OAuth 2.0 Device Authorization Grant を開始します。AI には次のような手順が表示されます。

ブラウザーで https://vibie.io/device?code=XXXX-YYYY を開き、Google でサインインして、Authorize をクリックしてください。その後、もう一度試すよう指示してください。

ブラウザーで認証した後、AI に同じリクエストを再試行するよう指示してください。サーバーはトークンを ~/.vibie/credentials.json（chmod 0600）に保存し、今後の呼び出しでも再利用します。

トークンは https://vibie.io/settings/api でいつでも無効化できます。

ツール

• vibie_create_site — フォルダーをアップロードして、新しい Vibie サイトを作成します。今後の更新で同じサイトを使用できるよう、フォルダー内に .vibie/site.json を自動で書き込みます。
• vibie_update_site — 既存のサイトに再デプロイします。指定がない場合は、.vibie/site.json からスラッグを読み込みます。
• vibie_list_sites — アカウント内のサイト一覧を表示します。
• vibie_get_site — スラッグを指定して、1 つのサイトのメタデータを取得します。

AI による一般的な利用方法

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

フォルダー構成

フォルダーからアップロードされる内容：

• index.html ＋ style.css ＋ js/、assets/ など — すべて含まれます
• 隠しファイル（.git、.vibie、.DS_Store）— 自動的にスキップされます
• node_modules/ — スキップされます
• 制限：サイトあたり 100 MB、アップロードあたり 500 ファイル、ファイルあたり 25 MB（Vibie のサーバーが検証します）

単一の HTML ファイル（名前は問いません）も使用できます。アップロード時に自動で index.html に名前が変更されます。

環境変数

変数	デフォルト	用途
VIBIE_API_BASE	https://vibie.io	ローカル開発用の上書き（http://localhost:3000）

ライセンス

MIT