vibie-mcp 0.1.0

package/README.md

@@ -0,0 +1,79 @@
+# vibie-mcp
+
+MCP server for [Vibie](https://vibie.io) — deploy static folders to permanent `*.vibie.page` URLs from Claude Desktop / Cursor / any MCP-compatible client.
+
+## Install
+
+In your MCP client's config, add:
+
+### Claude Desktop
+
+`%APPDATA%\Claude\claude_desktop_config.json` (Windows) or `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS):
+
+```json
+{
+  "mcpServers": {
+    "vibie": {
+      "command": "npx",
+      "args": ["-y", "vibie-mcp"]
+    }
+  }
+}
+```
+
+### Cursor
+
+Same pattern — add to your Cursor MCP config.
+
+After saving, restart your client.
+
+## First-time auth
+
+On first tool call, the server initiates an [OAuth 2.0 Device Authorization Grant](https://datatracker.ietf.org/doc/html/rfc8628). 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
+
+| Variable | Default | Purpose |
+|---|---|---|
+| `VIBIE_API_BASE` | `https://vibie.io` | Override for local dev (`http://localhost:3000`) |
+
+## License
+
+MIT

package/dist/api.js

@@ -0,0 +1,150 @@
+/**
+ * Vibie HTTP API 클라이언트 (sites CRUD).
+ *
+ * 모든 호출에 Authorization: Bearer <token> 헤더. 401 면 ApiAuthError 던짐
+ * (handler 가 catch 해서 credentials 폐기 + 재인증 안내).
+ */
+import { promises as fs } from "node:fs";
+import { join, relative, sep } from "node:path";
+const DEFAULT_BASE = process.env.VIBIE_API_BASE ?? "https://vibie.io";
+export class ApiAuthError extends Error {
+    constructor(message = "Authentication failed (token revoked or invalid).") {
+        super(message);
+        this.name = "ApiAuthError";
+    }
+}
+export class ApiError extends Error {
+    status;
+    code;
+    constructor(status, code, message) {
+        super(message);
+        this.name = "ApiError";
+        this.status = status;
+        this.code = code;
+    }
+}
+/** /api/sites GET — 본인 사이트 목록 */
+export async function listSites(token) {
+    const data = await jsonRequest(token, {
+        path: "/api/sites",
+        method: "GET"
+    });
+    return data.sites ?? [];
+}
+/** /api/sites/[slug] — 단일 site 메타. 우리 사용자 본인 / 공개 사이트만 응답. */
+export async function getSite(token, slug) {
+    // 우리 API 에 GET /api/sites/[slug] 가 없음 (PATCH/DELETE 만).
+    // list 에서 필터.
+    const sites = await listSites(token);
+    return sites.find((s) => s.slug === slug) ?? null;
+}
+/** /api/sites POST — multipart 로 폴더 전체 업로드, 새 사이트 생성 */
+export async function createSite(token, input) {
+    const files = await collectFolderFiles(input.folder);
+    const inferredName = input.name ?? folderBaseName(input.folder) ?? "site";
+    const fd = new FormData();
+    fd.append("name", inferredName);
+    fd.append("slug", inferredName);
+    fd.append("category", input.category ?? "misc");
+    if (input.note)
+        fd.append("note", input.note);
+    fd.append("isPublic", input.isPublic === false ? "false" : "true");
+    fd.append("paths", JSON.stringify(files.map((f) => f.relPath)));
+    for (const f of files) {
+        fd.append("files", new Blob([new Uint8Array(f.bytes)]), f.relPath);
+    }
+    const data = await jsonRequest(token, {
+        path: "/api/sites",
+        method: "POST",
+        body: fd
+    });
+    return data;
+}
+/** /api/sites/[slug]/deployments POST — 기존 site 재배포 */
+export async function updateSite(token, input) {
+    const files = await collectFolderFiles(input.folder);
+    const fd = new FormData();
+    if (input.note)
+        fd.append("note", input.note);
+    fd.append("paths", JSON.stringify(files.map((f) => f.relPath)));
+    for (const f of files) {
+        fd.append("files", new Blob([new Uint8Array(f.bytes)]), f.relPath);
+    }
+    const data = await jsonRequest(token, {
+        path: `/api/sites/${encodeURIComponent(input.slug)}/deployments`,
+        method: "POST",
+        body: fd
+    });
+    return data;
+}
+// ─── 내부 helpers ──────────────────────────────────────────────────────────
+async function jsonRequest(token, opts) {
+    const res = await fetch(`${DEFAULT_BASE}${opts.path}`, {
+        method: opts.method,
+        headers: { Authorization: `Bearer ${token}` },
+        body: opts.body
+    });
+    if (res.status === 401) {
+        throw new ApiAuthError();
+    }
+    if (!res.ok) {
+        let code = "UNKNOWN";
+        let message = `Request failed (${res.status})`;
+        try {
+            const data = (await res.json());
+            if (data?.error?.code)
+                code = data.error.code;
+            if (data?.error?.message)
+                message = data.error.message;
+        }
+        catch {
+            // body 가 JSON 아닐 수도
+        }
+        throw new ApiError(res.status, code, message);
+    }
+    return (await res.json());
+}
+async function collectFolderFiles(folder) {
+    const stat = await fs.stat(folder);
+    if (stat.isFile()) {
+        // 단일 파일 — 그대로 업로드
+        const bytes = await fs.readFile(folder);
+        const name = folder.split(sep).pop() ?? "index.html";
+        return [{ relPath: name, bytes }];
+    }
+    if (!stat.isDirectory()) {
+        throw new Error(`${folder} is neither a file nor a directory`);
+    }
+    const out = [];
+    async function walk(dir) {
+        const entries = await fs.readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            // hidden 디렉토리/파일 무시 (.git, .vibie, .DS_Store 등)
+            if (entry.name.startsWith("."))
+                continue;
+            if (entry.name === "node_modules")
+                continue;
+            const full = join(dir, entry.name);
+            if (entry.isDirectory()) {
+                await walk(full);
+            }
+            else if (entry.isFile()) {
+                const bytes = await fs.readFile(full);
+                const rel = relative(folder, full).split(sep).join("/");
+                out.push({ relPath: rel, bytes });
+            }
+        }
+    }
+    await walk(folder);
+    if (out.length === 0) {
+        throw new Error(`No files found in ${folder}`);
+    }
+    return out;
+}
+function folderBaseName(folder) {
+    const segs = folder.replace(/[\\/]+$/, "").split(/[\\/]/);
+    const last = segs[segs.length - 1];
+    if (!last || last === "." || last === "..")
+        return undefined;
+    return last;
+}

package/dist/auth.js

@@ -0,0 +1,134 @@
+/**
+ * Vibie 인증 — OAuth 2.0 Device Authorization Grant 클라이언트.
+ *
+ * 흐름:
+ *   1. ~/.vibie/credentials.json 에 토큰 있으면 그대로 사용
+ *   2. ~/.vibie/pending.json 에 in-flight device_code 있으면 한 번 poll
+ *      - authorized 면 토큰 저장 + return
+ *      - pending/slow_down 이면 AuthRequiredError 던짐 (사용자에게 URL 재안내)
+ *      - expired/denied 면 pending 폐기 후 step 3
+ *   3. 새 init 호출 → device_code 받음 → pending 저장 → AuthRequiredError 던짐
+ *
+ * AuthRequiredError 가 tool handler 에서 catch 돼서 사용자에게 URL/코드 보임.
+ * 사용자가 브라우저 authorize 후 다음 tool 호출 시 step 2 가 토큰 회수.
+ */
+import { promises as fs } from "node:fs";
+import { homedir } from "node:os";
+import { join, dirname } from "node:path";
+const HOME = homedir();
+const VIBIE_DIR = join(HOME, ".vibie");
+const CREDENTIALS_PATH = join(VIBIE_DIR, "credentials.json");
+const PENDING_PATH = join(VIBIE_DIR, "pending.json");
+const DEFAULT_BASE = process.env.VIBIE_API_BASE ?? "https://vibie.io";
+const CLIENT_NAME = "Vibie MCP";
+export class AuthRequiredError extends Error {
+    userCode;
+    verificationUriComplete;
+    constructor(userCode, verificationUriComplete) {
+        super(`Authentication required: visit ${verificationUriComplete}`);
+        this.name = "AuthRequiredError";
+        this.userCode = userCode;
+        this.verificationUriComplete = verificationUriComplete;
+    }
+}
+/** 토큰 받기. 없으면 device flow 시작 후 AuthRequiredError 던짐. */
+export async function getTokenOrInitiateFlow() {
+    // 1) 저장된 credentials
+    const cred = await readJson(CREDENTIALS_PATH);
+    if (cred?.token) {
+        return cred.token;
+    }
+    // 2) 진행 중인 device flow 가 있으면 한 번 poll
+    const pending = await readJson(PENDING_PATH);
+    if (pending?.device_code) {
+        if (Date.now() > pending.expires_at_ms) {
+            // 만료됐으니 폐기 후 새로 init
+            await removeFile(PENDING_PATH);
+        }
+        else {
+            const result = await pollDevice(pending.device_code);
+            if (result.status === "authorized" && result.access_token) {
+                await saveCredentials({
+                    token: result.access_token,
+                    saved_at: new Date().toISOString()
+                });
+                await removeFile(PENDING_PATH);
+                return result.access_token;
+            }
+            if (result.status === "pending" || result.status === "slow_down") {
+                throw new AuthRequiredError(pending.user_code, pending.verification_uri_complete);
+            }
+            // expired/denied — pending 폐기 후 새로 init
+            await removeFile(PENDING_PATH);
+        }
+    }
+    // 3) 새 device flow init
+    const init = await initDevice();
+    await savePending({
+        device_code: init.device_code,
+        user_code: init.user_code,
+        verification_uri_complete: init.verification_uri_complete,
+        expires_at_ms: Date.now() + init.expires_in * 1000
+    });
+    throw new AuthRequiredError(init.user_code, init.verification_uri_complete);
+}
+/** 저장된 토큰 명시적 삭제 — 로그아웃. */
+export async function clearCredentials() {
+    await removeFile(CREDENTIALS_PATH);
+    await removeFile(PENDING_PATH);
+}
+async function initDevice() {
+    const res = await fetch(`${DEFAULT_BASE}/api/auth/device/init`, {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify({ client_name: CLIENT_NAME })
+    });
+    if (!res.ok) {
+        const text = await res.text().catch(() => "");
+        throw new Error(`Vibie /init failed (${res.status}): ${text}`);
+    }
+    return (await res.json());
+}
+async function pollDevice(deviceCode) {
+    const res = await fetch(`${DEFAULT_BASE}/api/auth/device/poll`, {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify({ device_code: deviceCode })
+    });
+    if (!res.ok) {
+        const text = await res.text().catch(() => "");
+        throw new Error(`Vibie /poll failed (${res.status}): ${text}`);
+    }
+    return (await res.json());
+}
+// ─── 파일 IO helpers ──────────────────────────────────────────────────────
+async function readJson(path) {
+    try {
+        const raw = await fs.readFile(path, "utf8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+async function ensureDir(path) {
+    await fs.mkdir(dirname(path), { recursive: true });
+}
+async function saveCredentials(cred) {
+    await ensureDir(CREDENTIALS_PATH);
+    await fs.writeFile(CREDENTIALS_PATH, JSON.stringify(cred, null, 2), {
+        mode: 0o600
+    });
+}
+async function savePending(p) {
+    await ensureDir(PENDING_PATH);
+    await fs.writeFile(PENDING_PATH, JSON.stringify(p, null, 2), { mode: 0o600 });
+}
+async function removeFile(path) {
+    try {
+        await fs.unlink(path);
+    }
+    catch {
+        // already missing
+    }
+}

package/dist/index.js

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+/**
+ * vibie-mcp — Vibie 를 위한 MCP server.
+ *
+ * 사용:
+ *   npx vibie-mcp
+ *
+ * Claude Desktop / Cursor config 예시:
+ *   {
+ *     "mcpServers": {
+ *       "vibie": { "command": "npx", "args": ["-y", "vibie-mcp"] }
+ *     }
+ *   }
+ *
+ * 첫 사용 시 사용자에게 https://vibie.io/device 인증 URL 안내 — credentials 는
+ * ~/.vibie/credentials.json 에 자동 저장 (chmod 0600).
+ *
+ * Env (옵션):
+ *   VIBIE_API_BASE — default https://vibie.io. 로컬 dev 시 http://localhost:3000.
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+import { toolDefinitions, handleToolCall } from "./tools.js";
+const server = new Server({
+    name: "vibie",
+    version: "0.1.0"
+}, {
+    capabilities: { tools: {} }
+});
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: toolDefinitions
+}));
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const name = request.params.name;
+    const args = (request.params.arguments ?? {});
+    return handleToolCall(name, args);
+});
+const transport = new StdioServerTransport();
+await server.connect(transport);

package/dist/site-marker.js

@@ -0,0 +1,44 @@
+/**
+ * `.vibie/site.json` 폴더 마커 — 한 폴더가 어떤 vibie 사이트에 매핑되는지 추적.
+ *
+ * Vercel CLI 의 `.vercel/project.json` 같은 패턴. update 시 "어떤 사이트?" 물을 필요 X.
+ *
+ * 파일 위치: {folder}/.vibie/site.json
+ * 함께 자동 생성: {folder}/.vibie/.gitignore — 폴더 전체 git ignore (사용자 site 와 분리)
+ */
+import { promises as fs } from "node:fs";
+import { join } from "node:path";
+const MARKER_DIRNAME = ".vibie";
+const MARKER_FILENAME = "site.json";
+const GITIGNORE_CONTENT = "# vibie cli local state\n*\n!.gitignore\n";
+export async function readMarker(folder) {
+    try {
+        const raw = await fs.readFile(join(folder, MARKER_DIRNAME, MARKER_FILENAME), "utf8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+export async function writeMarker(folder, marker) {
+    const dir = join(folder, MARKER_DIRNAME);
+    await fs.mkdir(dir, { recursive: true });
+    await fs.writeFile(join(dir, MARKER_FILENAME), JSON.stringify(marker, null, 2), "utf8");
+    // .gitignore 자동 — 사용자가 vibie 마커를 자기 git 에 안 넣게
+    const gitignorePath = join(dir, ".gitignore");
+    try {
+        await fs.access(gitignorePath);
+        // 이미 있으면 손대지 않음
+    }
+    catch {
+        await fs.writeFile(gitignorePath, GITIGNORE_CONTENT, "utf8");
+    }
+}
+export async function clearMarker(folder) {
+    try {
+        await fs.unlink(join(folder, MARKER_DIRNAME, MARKER_FILENAME));
+    }
+    catch {
+        // 없으면 그만
+    }
+}

package/dist/tools.js

@@ -0,0 +1,252 @@
+/**
+ * 4개 MCP tool 정의 + handler.
+ *
+ * - vibie_create_site: 새 사이트 생성 + .vibie/site.json 자동 생성
+ * - vibie_update_site: 같은 폴더 재배포. slug 안 주면 .vibie/site.json 에서 읽음
+ * - vibie_list_sites: 본인 사이트 목록
+ * - vibie_get_site: 특정 slug 메타
+ *
+ * 인증 친화 — 미인증이면 AuthRequiredError catch 후 사용자에게 URL/코드 안내.
+ */
+import { resolve } from "node:path";
+import { AuthRequiredError, getTokenOrInitiateFlow, clearCredentials } from "./auth.js";
+import { ApiAuthError, ApiError, createSite, getSite, listSites, updateSite } from "./api.js";
+import { readMarker, writeMarker } from "./site-marker.js";
+// ─── tool 정의들 (LLM 한테 보이는 description 이 가장 중요) ──────────────────
+export const toolDefinitions = [
+    {
+        name: "vibie_create_site",
+        description: "Create a NEW Vibie site by uploading a local folder. Use this when the user wants to publish a brand new site, or when no .vibie/site.json marker exists in the folder. Vibie hosts static HTML/CSS/JS at a permanent URL like my-site-a3f9.vibie.page. Auto-creates a .vibie/site.json marker in the folder for future updates.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                folder: {
+                    type: "string",
+                    description: "Absolute or relative path to the folder containing index.html (or a single HTML file). Required."
+                },
+                name: {
+                    type: "string",
+                    description: "Display name. Defaults to folder name."
+                },
+                category: {
+                    type: "string",
+                    description: "Category id (portfolio / wedding / landing / event / game / photo / linkbio / misc). Defaults to misc."
+                },
+                is_public: {
+                    type: "boolean",
+                    description: "Whether the site appears in the public gallery. Defaults to true."
+                },
+                note: {
+                    type: "string",
+                    description: "Optional deployment note (changelog-style)."
+                }
+            },
+            required: ["folder"],
+            additionalProperties: false
+        }
+    },
+    {
+        name: "vibie_update_site",
+        description: "Update an existing Vibie site with new content from a local folder. Use this when the user wants to re-deploy or push changes to an already-published site. If .vibie/site.json marker exists in the folder, the slug is read automatically; otherwise pass slug explicitly. Same URL, new content.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                folder: {
+                    type: "string",
+                    description: "Folder to upload. Required."
+                },
+                slug: {
+                    type: "string",
+                    description: "Site slug to update (e.g. my-site-a3f9). If omitted, read from .vibie/site.json in folder."
+                },
+                note: {
+                    type: "string",
+                    description: "Optional deployment note (changelog-style)."
+                }
+            },
+            required: ["folder"],
+            additionalProperties: false
+        }
+    },
+    {
+        name: "vibie_list_sites",
+        description: "List all sites owned by the current Vibie user. Returns slug, display name, category, URL, visibility, and last update time. Use this to discover what sites the user already has, e.g. before update.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+            additionalProperties: false
+        }
+    },
+    {
+        name: "vibie_get_site",
+        description: "Get metadata for a single Vibie site by slug. Returns name, category, URL, visibility, like count, timestamps.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                slug: {
+                    type: "string",
+                    description: "Site slug, e.g. my-site-a3f9"
+                }
+            },
+            required: ["slug"],
+            additionalProperties: false
+        }
+    }
+];
+// ─── handler dispatcher ────────────────────────────────────────────────────
+export async function handleToolCall(name, args) {
+    try {
+        const token = await getTokenOrInitiateFlow();
+        switch (name) {
+            case "vibie_create_site":
+                return await handleCreate(token, args);
+            case "vibie_update_site":
+                return await handleUpdate(token, args);
+            case "vibie_list_sites":
+                return await handleList(token);
+            case "vibie_get_site":
+                return await handleGet(token, args);
+            default:
+                return errorResult(`Unknown tool: ${name}`);
+        }
+    }
+    catch (err) {
+        if (err instanceof AuthRequiredError) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "Vibie 인증이 필요합니다. 사용자에게 다음 단계를 안내해 주세요:\n\n" +
+                            `1. 브라우저로 이 URL 을 여세요: ${err.verificationUriComplete}\n` +
+                            `2. Google 로 로그인하고 코드 ${err.userCode} 를 확인한 뒤 [권한 부여] 버튼을 누르세요.\n` +
+                            `3. 완료되면 다시 '배포해줘' 또는 원래 요청을 해주세요. 같은 도구 호출이 다시 들어오면 토큰을 가져와서 진행합니다.\n\n` +
+                            `(코드는 10분 안에 사용해야 합니다. 만료되면 새 코드가 발급됩니다.)`
+                    }
+                ]
+            };
+        }
+        if (err instanceof ApiAuthError) {
+            // 토큰이 revoke 됐거나 invalid — credentials 폐기 + 재인증 안내
+            await clearCredentials();
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "Vibie 토큰이 더 이상 유효하지 않습니다 (revoke 됐거나 만료). " +
+                            "credentials 를 비웠습니다. 같은 도구를 다시 호출해주시면 새 인증 흐름을 시작합니다."
+                    }
+                ],
+                isError: true
+            };
+        }
+        if (err instanceof ApiError) {
+            return errorResult(`Vibie API ${err.status} ${err.code}: ${err.message}`);
+        }
+        return errorResult(err instanceof Error ? err.message : "Unknown error");
+    }
+}
+// ─── 개별 handler ──────────────────────────────────────────────────────────
+async function handleCreate(token, args) {
+    const folder = requireStr(args, "folder");
+    const absFolder = resolve(folder);
+    const result = await createSite(token, {
+        folder: absFolder,
+        name: optStr(args, "name"),
+        category: optStr(args, "category"),
+        isPublic: optBool(args, "is_public"),
+        note: optStr(args, "note")
+    });
+    // .vibie/site.json 자동 생성 — 다음 배포 시 update_site 가 slug 자동 인지
+    await writeMarker(absFolder, {
+        slug: result.site.slug,
+        siteId: result.site.id,
+        url: result.url,
+        lastDeployed: new Date().toISOString()
+    });
+    return successResult(`✓ 새 Vibie 사이트가 배포됐습니다.\n` +
+        `  URL: ${result.url}\n` +
+        `  Slug: ${result.site.slug}\n` +
+        `  Name: ${result.site.display_name}\n` +
+        `  Public: ${result.site.is_public}\n\n` +
+        `다음에 같은 폴더에서 vibie_update_site 를 호출하면 같은 사이트가 갱신됩니다 (.vibie/site.json 자동 인식).`);
+}
+async function handleUpdate(token, args) {
+    const folder = requireStr(args, "folder");
+    const absFolder = resolve(folder);
+    let slug = optStr(args, "slug");
+    if (!slug) {
+        const marker = await readMarker(absFolder);
+        if (!marker) {
+            return errorResult(`slug 를 알 수 없습니다. ${absFolder}/.vibie/site.json 마커가 없고 인자로도 slug 가 전달되지 않았습니다.\n` +
+                `옵션:\n` +
+                `1. 새 사이트로 만들려면 vibie_create_site 호출\n` +
+                `2. 기존 사이트로 업데이트하려면 slug 인자를 명시 (예: my-site-a3f9). vibie_list_sites 로 본인 사이트 목록 확인 가능.`);
+        }
+        slug = marker.slug;
+    }
+    const result = await updateSite(token, {
+        folder: absFolder,
+        slug,
+        note: optStr(args, "note")
+    });
+    // marker 의 lastDeployed 갱신
+    const marker = await readMarker(absFolder);
+    if (marker) {
+        await writeMarker(absFolder, {
+            ...marker,
+            lastDeployed: new Date().toISOString()
+        });
+    }
+    return successResult(`✓ Vibie 사이트가 업데이트됐습니다.\n` +
+        `  URL: ${result.url}\n` +
+        `  Slug: ${slug}\n` +
+        `  Deployment: ${result.deployment.id}\n`);
+}
+async function handleList(token) {
+    const sites = await listSites(token);
+    if (sites.length === 0) {
+        return successResult("본인 명의로 배포된 사이트가 없습니다. vibie_create_site 로 첫 사이트를 만들어 보세요.");
+    }
+    const lines = sites.map((s) => {
+        const flag = s.is_blocked ? " [차단]" : s.is_public ? "" : " [비공개]";
+        const tpl = s.is_template ? " [TEMPLATE]" : "";
+        return `· ${s.slug}.vibie.page  —  ${s.display_name} (${s.category})${flag}${tpl}, ♥${s.like_count}, updated ${s.updated_at}`;
+    });
+    return successResult(`본인 Vibie 사이트 (${sites.length}개):\n${lines.join("\n")}`);
+}
+async function handleGet(token, args) {
+    const slug = requireStr(args, "slug");
+    const site = await getSite(token, slug);
+    if (!site) {
+        return errorResult(`사이트 '${slug}' 를 본인 계정에서 찾을 수 없습니다.`);
+    }
+    return successResult(`${site.display_name} (${site.slug}.vibie.page)\n` +
+        `  Category: ${site.category}\n` +
+        `  Public: ${site.is_public}\n` +
+        `  Template: ${site.is_template}\n` +
+        `  Likes: ${site.like_count}\n` +
+        `  Created: ${site.created_at}\n` +
+        `  Updated: ${site.updated_at}`);
+}
+// ─── small helpers ────────────────────────────────────────────────────────
+function requireStr(args, key) {
+    const v = args[key];
+    if (typeof v !== "string" || v.length === 0) {
+        throw new Error(`Argument '${key}' is required and must be a non-empty string.`);
+    }
+    return v;
+}
+function optStr(args, key) {
+    const v = args[key];
+    return typeof v === "string" && v.length > 0 ? v : undefined;
+}
+function optBool(args, key) {
+    const v = args[key];
+    return typeof v === "boolean" ? v : undefined;
+}
+function successResult(text) {
+    return { content: [{ type: "text", text }] };
+}
+function errorResult(text) {
+    return { content: [{ type: "text", text }], isError: true };
+}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "vibie-mcp",
+  "version": "0.1.0",
+  "description": "Vibie MCP server — deploy folders to vibie.page from Claude Desktop / Cursor / any MCP client.",
+  "license": "MIT",
+  "homepage": "https://vibie.io",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/shdomi8599/vibie.git",
+    "directory": "packages/vibie-mcp"
+  },
+  "keywords": [
+    "vibie",
+    "mcp",
+    "model-context-protocol",
+    "claude",
+    "cursor",
+    "vibe-coding",
+    "static-hosting",
+    "deploy"
+  ],
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "vibie-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepare": "npm run build",
+    "start": "node dist/index.js",
+    "dev": "tsc --watch"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.5.0"
+  }
+}