vibie-mcp 0.1.0 → 0.2.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vibie
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -4,11 +4,17 @@ MCP server for [Vibie](https://vibie.io) — deploy static folders to permanent
 
 ## Install
 
-In your MCP client's config, add:
+### One-line auto setup (recommended)
 
-### Claude Desktop
+```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
 
-`%APPDATA%\Claude\claude_desktop_config.json` (Windows) or `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS):
+If auto setup doesn't fit your client, add this to your MCP config (`claude_desktop_config.json`, `~/.cursor/mcp.json`, etc.):
 
 ```json
 {
@@ -21,11 +27,7 @@ In your MCP client's config, add:
 }
 ```
 
-### Cursor
-
-Same pattern — add to your Cursor MCP config.
-
-After saving, restart your client.
+After saving, fully quit and restart your client.
 
 ## First-time auth
 

package/dist/index.js

@@ -22,9 +22,17 @@ 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";
+import { runSetup } from "./setup.js";
+// 서브커맨드 분기. `npx vibie-mcp setup` 으로 호출 시 setup 모드.
+// 그 외엔 stdio MCP server 로 동작 (Claude Desktop / Cursor 가 spawn).
+const subcommand = process.argv[2];
+if (subcommand === "setup") {
+    await runSetup();
+    process.exit(0);
+}
 const server = new Server({
     name: "vibie",
-    version: "0.1.0"
+    version: "0.2.1"
 }, {
     capabilities: { tools: {} }
 });

package/dist/setup.js

@@ -0,0 +1,134 @@
+/**
+ * `vibie-mcp setup` — Claude Desktop / Cursor 의 MCP config 파일을 자동 탐지해서
+ * `vibie` 항목을 추가/갱신한다.
+ *
+ * 지원 클라이언트:
+ *   - Claude Desktop (Win Store + APPDATA, macOS, Linux)
+ *   - Cursor (글로벌 ~/.cursor/mcp.json)
+ *
+ * 없는 client 는 조용히 skip. 이미 vibie 항목이 있으면 갱신.
+ *
+ * 사용법: npx vibie-mcp setup
+ */
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { homedir, platform } from "node:os";
+const VIBIE_ENTRY = {
+    command: "npx",
+    args: ["-y", "vibie-mcp"]
+};
+function findClaudeDesktopConfig() {
+    const home = homedir();
+    const candidates = [];
+    if (platform() === "win32") {
+        // Microsoft Store 버전 — %LOCALAPPDATA%\Packages\Claude_xxx\LocalCache\Roaming\Claude\...
+        const localAppData = process.env.LOCALAPPDATA;
+        if (localAppData) {
+            const packages = join(localAppData, "Packages");
+            try {
+                if (existsSync(packages)) {
+                    for (const entry of readdirSync(packages)) {
+                        if (entry.startsWith("Claude_")) {
+                            candidates.push(join(packages, entry, "LocalCache", "Roaming", "Claude", "claude_desktop_config.json"));
+                        }
+                    }
+                }
+            }
+            catch {
+                // ignore — best-effort scan
+            }
+        }
+        // 일반 인스톨러 버전 — %APPDATA%\Claude\...
+        if (process.env.APPDATA) {
+            candidates.push(join(process.env.APPDATA, "Claude", "claude_desktop_config.json"));
+        }
+    }
+    else if (platform() === "darwin") {
+        candidates.push(join(home, "Library", "Application Support", "Claude", "claude_desktop_config.json"));
+    }
+    else {
+        // linux 등
+        candidates.push(join(home, ".config", "Claude", "claude_desktop_config.json"));
+    }
+    // 이미 존재하는 첫 후보. 없으면 첫 후보 경로를 새로 만들 자리로 반환.
+    const existing = candidates.find((p) => existsSync(p));
+    return existing ?? candidates[0];
+}
+function discoverClients() {
+    const home = homedir();
+    const targets = [];
+    const claudePath = findClaudeDesktopConfig();
+    if (claudePath) {
+        targets.push({
+            id: "claude-desktop",
+            label: "Claude Desktop",
+            configPath: claudePath,
+            exists: existsSync(claudePath)
+        });
+    }
+    const cursorPath = join(home, ".cursor", "mcp.json");
+    targets.push({
+        id: "cursor",
+        label: "Cursor",
+        configPath: cursorPath,
+        exists: existsSync(cursorPath)
+    });
+    return targets;
+}
+function installToTarget(target) {
+    let config = {};
+    if (target.exists) {
+        const raw = readFileSync(target.configPath, "utf8");
+        if (raw.trim().length > 0) {
+            config = JSON.parse(raw);
+        }
+    }
+    else {
+        mkdirSync(dirname(target.configPath), { recursive: true });
+    }
+    const mcpServers = config.mcpServers && typeof config.mcpServers === "object"
+        ? config.mcpServers
+        : {};
+    const alreadyExists = "vibie" in mcpServers;
+    mcpServers.vibie = VIBIE_ENTRY;
+    config.mcpServers = mcpServers;
+    writeFileSync(target.configPath, JSON.stringify(config, null, 2) + "\n", "utf8");
+    return alreadyExists ? "updated" : "added";
+}
+export async function runSetup() {
+    console.log("🔵 Vibie MCP 설치를 시작합니다.\n");
+    const targets = discoverClients();
+    const installed = [];
+    const failed = [];
+    for (const target of targets) {
+        try {
+            const result = installToTarget(target);
+            installed.push({ label: target.label, result, path: target.configPath });
+        }
+        catch (err) {
+            failed.push({
+                label: target.label,
+                error: err instanceof Error ? err.message : String(err)
+            });
+        }
+    }
+    for (const item of installed) {
+        const verb = item.result === "updated" ? "갱신" : "추가";
+        console.log(`✓ ${item.label}: vibie 항목 ${verb}`);
+        console.log(`    ${item.path}`);
+    }
+    for (const item of failed) {
+        console.log(`✗ ${item.label}: ${item.error}`);
+    }
+    console.log("");
+    if (installed.length === 0) {
+        console.log("설치할 수 있는 클라이언트를 찾지 못했어요. Claude Desktop 또는 Cursor 가 설치돼 있는지 확인해 주세요.");
+        return;
+    }
+    console.log("📌 다음 단계");
+    console.log("  1. 클라이언트를 완전히 종료 후 다시 실행 (Claude Desktop 은 트레이에서 Quit 후 재시작)");
+    console.log('  2. 대화창에서 "내 vibie 사이트 목록 보여줘" 같은 메시지로 시작');
+    console.log("  3. 처음 호출 시 브라우저로 권한 부여 페이지가 안내됩니다 (Google 로그인)");
+    console.log("");
+    console.log("문제가 있으면: https://www.npmjs.com/package/vibie-mcp");
+}

package/package.json

@@ -1,13 +1,16 @@
 {
   "name": "vibie-mcp",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "Vibie MCP server — deploy folders to vibie.page from Claude Desktop / Cursor / any MCP client.",
   "license": "MIT",
   "homepage": "https://vibie.io",
+  "mcpName": "io.github.shdomi8599/vibie-mcp",
   "repository": {
     "type": "git",
-    "url": "https://github.com/shdomi8599/vibie.git",
-    "directory": "packages/vibie-mcp"
+    "url": "git+https://github.com/shdomi8599/vibie-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/shdomi8599/vibie-mcp/issues"
   },
   "keywords": [
     "vibie",