vibekit-mcp 0.2.0 → 0.4.0

package/README.md

@@ -1,6 +1,6 @@
 # vibekit-mcp
 
-MCP (Model Context Protocol) server for [VibeKit](https://vibekit.bot) — use AI coding tasks as native tools in Claude Desktop, Cursor, and other MCP-compatible clients.
+MCP server for VibeKit — deploy apps, manage hosting, and chat with AI agents from any MCP client.
 
 ## Installation
 
@@ -14,7 +14,7 @@ npm install -g vibekit-mcp
    - Open [@the_vibe_kit_bot](https://t.me/the_vibe_kit_bot) in Telegram
    - Send `/apikey` to generate your key
 
-2. Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
+2. Add to your MCP client config (e.g. Claude Desktop) (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
 
 ```json
 {
@@ -29,29 +29,80 @@ npm install -g vibekit-mcp
 }
 ```
 
-3. Restart Claude Desktop
+3. Restart your MCP client
 
 ## Available Tools
 
+### Hosting
+
+| Tool | Description |
+|------|-------------|
+| `vibekit_list_apps` | List all hosted apps |
+| `vibekit_get_app` | Get details about a specific app |
+| `vibekit_create_app` | Create new app from template |
+| `vibekit_deploy` | Deploy GitHub repo to hosting |
+| `vibekit_redeploy` | Redeploy app with latest code |
+| `vibekit_app_logs` | Get application logs |
+| `vibekit_restart_app` | Restart an app |
+| `vibekit_stop_app` | Stop an app |
+| `vibekit_start_app` | Start a stopped app |
+| `vibekit_app_env` | Get app environment variables |
+| `vibekit_set_env` | Set app environment variables |
+| `vibekit_delete_app` | Delete an app permanently |
+
+### Agent
+
+| Tool | Description |
+|------|-------------|
+| `vibekit_chat` | Chat with an app's AI agent |
+| `vibekit_agent_status` | Get agent status |
+| `vibekit_agent_history` | Get chat history with agent |
+
+### Database
+
+| Tool | Description |
+|------|-------------|
+| `vibekit_enable_database` | Enable database for an app |
+| `vibekit_database_status` | Get database status and connection info |
+
+### QA
+
+| Tool | Description |
+|------|-------------|
+| `vibekit_run_qa` | Run automated QA tests |
+| `vibekit_qa_status` | Get QA test results |
+
+### Tasks
+
 | Tool | Description |
 |------|-------------|
-| `vibekit_submit_task` | Submit a coding task. AI writes code, commits to GitHub, deploys to Vercel. |
-| `vibekit_get_task` | Get status/result of a task |
+| `vibekit_submit_task` | Submit a coding task |
+| `vibekit_get_task` | Get task status/result |
 | `vibekit_list_tasks` | List recent tasks |
-| `vibekit_wait_for_task` | Wait for a task to complete (polls until done) |
-| `vibekit_create_schedule` | Create a recurring scheduled task |
-| `vibekit_list_schedules` | List all scheduled tasks |
-| `vibekit_delete_schedule` | Delete a scheduled task |
+| `vibekit_wait_for_task` | Wait for task completion |
+| `vibekit_create_schedule` | Create recurring scheduled task |
+| `vibekit_list_schedules` | List scheduled tasks |
+| `vibekit_delete_schedule` | Delete scheduled task |
+
+### Account
+
+| Tool | Description |
+|------|-------------|
 | `vibekit_account` | Get account info (plan, credits, usage) |
+| `vibekit_list_skills` | List implementation skills |
+| `vibekit_get_skill` | Fetch specific skill content |
 
 ## Example Usage
 
-Once configured, you can ask Claude things like:
+Once configured, you can use prompts like:
 
-- "Use VibeKit to build me a landing page for my startup"
-- "Submit a task to VibeKit: Add a contact form to my website"
-- "Check my VibeKit account balance"
-- "Create a weekly schedule to improve SEO on my repo"
+- "Deploy my GitHub repo to VibeKit and create a new app"
+- "Chat with the AI agent for my app about adding a contact form"
+- "Show me the logs for my app and restart it if there are errors"
+- "Enable a database for my app and check its status"
+- "Run QA tests on my deployed app"
+- "Check my VibeKit account balance and list my apps"
+- "Create a weekly schedule to improve my app's performance"
 
 ## Environment Variables
 
@@ -65,4 +116,4 @@ Once configured, you can ask Claude things like:
 - [VibeKit Website](https://vibekit.bot)
 - [API Documentation](https://vibekit.bot/SKILL.md)
 - [Get API Key](https://t.me/the_vibe_kit_bot)
-- [GitHub](https://github.com/609NFT/vibekit)
+- [GitHub](https://github.com/609NFT/vibekit)

package/dist/index.js

@@ -38,9 +38,298 @@ async function apiRequest(method, path, body) {
 }
 // Tool definitions
 const tools = [
+    // Hosting & Apps
+    {
+        name: "vibekit_list_apps",
+        description: "List all hosted apps in your VibeKit account.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+    },
+    {
+        name: "vibekit_get_app",
+        description: "Get details about a specific hosted app.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                appId: {
+                    type: "string",
+                    description: "The app ID to get details for",
+                },
+            },
+            required: ["appId"],
+        },
+    },
+    {
+        name: "vibekit_create_app",
+        description: "Create a new hosted app from a template.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                template: {
+                    type: "string",
+                    description: "Template to use (e.g., 'nextjs', 'react', 'express')",
+                },
+                subdomain: {
+                    type: "string",
+                    description: "Subdomain for the app (will be deployed to {subdomain}.vibekit.bot)",
+                },
+            },
+            required: ["template", "subdomain"],
+        },
+    },
+    {
+        name: "vibekit_deploy",
+        description: "Deploy a GitHub repo to VibeKit hosting.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                repo: {
+                    type: "string",
+                    description: "GitHub repo in format 'owner/repo'",
+                },
+                subdomain: {
+                    type: "string",
+                    description: "Subdomain for the app (will be deployed to {subdomain}.vibekit.bot)",
+                },
+            },
+            required: ["repo", "subdomain"],
+        },
+    },
+    {
+        name: "vibekit_redeploy",
+        description: "Redeploy an existing hosted app to update it with latest code.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                appId: {
+                    type: "string",
+                    description: "The app ID to redeploy",
+                },
+            },
+            required: ["appId"],
+        },
+    },
+    {
+        name: "vibekit_app_logs",
+        description: "Get application logs for debugging and monitoring.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                appId: {
+                    type: "string",
+                    description: "The app ID to get logs for",
+                },
+                lines: {
+                    type: "number",
+                    description: "Number of log lines to retrieve (default: 100)",
+                },
+            },
+            required: ["appId"],
+        },
+    },
+    {
+        name: "vibekit_restart_app",
+        description: "Restart a hosted app.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                appId: {
+                    type: "string",
+                    description: "The app ID to restart",
+                },
+            },
+            required: ["appId"],
+        },
+    },
+    {
+        name: "vibekit_stop_app",
+        description: "Stop a hosted app.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                appId: {
+                    type: "string",
+                    description: "The app ID to stop",
+                },
+            },
+            required: ["appId"],
+        },
+    },
+    {
+        name: "vibekit_start_app",
+        description: "Start a stopped hosted app.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                appId: {
+                    type: "string",
+                    description: "The app ID to start",
+                },
+            },
+            required: ["appId"],
+        },
+    },
+    {
+        name: "vibekit_app_env",
+        description: "Get environment variables for a hosted app.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                appId: {
+                    type: "string",
+                    description: "The app ID to get environment variables for",
+                },
+            },
+            required: ["appId"],
+        },
+    },
+    {
+        name: "vibekit_set_env",
+        description: "Set environment variables for a hosted app.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                appId: {
+                    type: "string",
+                    description: "The app ID to set environment variables for",
+                },
+                vars: {
+                    type: "object",
+                    description: "Object of key-value pairs to set as environment variables",
+                },
+            },
+            required: ["appId", "vars"],
+        },
+    },
+    {
+        name: "vibekit_delete_app",
+        description: "Delete a hosted app permanently.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                appId: {
+                    type: "string",
+                    description: "The app ID to delete",
+                },
+            },
+            required: ["appId"],
+        },
+    },
+    // AI Agent
+    {
+        name: "vibekit_chat",
+        description: "Chat with an app's AI agent. The agent can read, write, and modify the app's code.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                appId: {
+                    type: "string",
+                    description: "The app ID to chat with the agent for",
+                },
+                message: {
+                    type: "string",
+                    description: "Message to send to the AI agent",
+                },
+            },
+            required: ["appId", "message"],
+        },
+    },
+    {
+        name: "vibekit_agent_status",
+        description: "Get the status of an app's AI agent.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                appId: {
+                    type: "string",
+                    description: "The app ID to get agent status for",
+                },
+            },
+            required: ["appId"],
+        },
+    },
+    {
+        name: "vibekit_agent_history",
+        description: "Get chat history with an app's AI agent.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                appId: {
+                    type: "string",
+                    description: "The app ID to get agent history for",
+                },
+                limit: {
+                    type: "number",
+                    description: "Maximum number of messages to return (default: 20)",
+                },
+            },
+            required: ["appId"],
+        },
+    },
+    // Database
+    {
+        name: "vibekit_enable_database",
+        description: "Enable database for a hosted app.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                appId: {
+                    type: "string",
+                    description: "The app ID to enable database for",
+                },
+            },
+            required: ["appId"],
+        },
+    },
+    {
+        name: "vibekit_database_status",
+        description: "Get database status and connection info for an app.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                appId: {
+                    type: "string",
+                    description: "The app ID to get database status for",
+                },
+            },
+            required: ["appId"],
+        },
+    },
+    // QA
+    {
+        name: "vibekit_run_qa",
+        description: "Run automated QA tests on a hosted app.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                appId: {
+                    type: "string",
+                    description: "The app ID to run QA tests for",
+                },
+            },
+            required: ["appId"],
+        },
+    },
+    {
+        name: "vibekit_qa_status",
+        description: "Get QA test results and status for an app.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                appId: {
+                    type: "string",
+                    description: "The app ID to get QA status for",
+                },
+            },
+            required: ["appId"],
+        },
+    },
+    // Tasks (existing)
     {
         name: "vibekit_submit_task",
-        description: "Submit a coding task to VibeKit. The AI will write code, commit to GitHub, and deploy to Vercel. Returns a task ID to poll for results.",
+        description: "Submit a coding task to VibeKit. The AI will write code, commit to GitHub, and deploy to {subdomain}.vibekit.bot. Returns a task ID to poll for results.",
         inputSchema: {
             type: "object",
             properties: {
@@ -166,6 +455,7 @@ const tools = [
             required: ["scheduleId"],
         },
     },
+    // Account
     {
         name: "vibekit_account",
         description: "Get VibeKit account info including plan, credits balance, and usage.",
@@ -206,6 +496,94 @@ const tools = [
 async function handleTool(name, args) {
     let result;
     switch (name) {
+        // Hosting & Apps
+        case "vibekit_list_apps":
+            result = await apiRequest("GET", "/hosting/apps");
+            break;
+        case "vibekit_get_app":
+            result = await apiRequest("GET", `/hosting/app/${args.appId}`);
+            break;
+        case "vibekit_create_app":
+            result = await apiRequest("POST", "/hosting/apps", {
+                template: args.template,
+                subdomain: args.subdomain,
+            });
+            break;
+        case "vibekit_deploy":
+            result = await apiRequest("POST", "/hosting/deploy", {
+                repo: args.repo,
+                subdomain: args.subdomain,
+            });
+            break;
+        case "vibekit_redeploy":
+            result = await apiRequest("POST", `/hosting/app/${args.appId}/redeploy`);
+            break;
+        case "vibekit_app_logs": {
+            let path = `/hosting/app/${args.appId}/logs`;
+            if (args.lines) {
+                path += `?lines=${args.lines}`;
+            }
+            else {
+                path += "?lines=100";
+            }
+            result = await apiRequest("GET", path);
+            break;
+        }
+        case "vibekit_restart_app":
+            result = await apiRequest("POST", `/hosting/app/${args.appId}/restart`);
+            break;
+        case "vibekit_stop_app":
+            result = await apiRequest("POST", `/hosting/app/${args.appId}/stop`);
+            break;
+        case "vibekit_start_app":
+            result = await apiRequest("POST", `/hosting/app/${args.appId}/start`);
+            break;
+        case "vibekit_app_env":
+            result = await apiRequest("GET", `/hosting/app/${args.appId}/env`);
+            break;
+        case "vibekit_set_env":
+            result = await apiRequest("PUT", `/hosting/app/${args.appId}/env`, {
+                vars: args.vars,
+            });
+            break;
+        case "vibekit_delete_app":
+            result = await apiRequest("DELETE", `/hosting/app/${args.appId}`);
+            break;
+        // AI Agent
+        case "vibekit_chat":
+            result = await apiRequest("POST", `/hosting/app/${args.appId}/agent`, {
+                message: args.message,
+            });
+            break;
+        case "vibekit_agent_status":
+            result = await apiRequest("GET", `/hosting/app/${args.appId}/agent/status`);
+            break;
+        case "vibekit_agent_history": {
+            let path = `/hosting/app/${args.appId}/agent/history`;
+            if (args.limit) {
+                path += `?limit=${args.limit}`;
+            }
+            else {
+                path += "?limit=20";
+            }
+            result = await apiRequest("GET", path);
+            break;
+        }
+        // Database
+        case "vibekit_enable_database":
+            result = await apiRequest("POST", `/hosting/app/${args.appId}/database`);
+            break;
+        case "vibekit_database_status":
+            result = await apiRequest("GET", `/hosting/app/${args.appId}/database`);
+            break;
+        // QA
+        case "vibekit_run_qa":
+            result = await apiRequest("POST", `/hosting/app/${args.appId}/qa`);
+            break;
+        case "vibekit_qa_status":
+            result = await apiRequest("GET", `/hosting/app/${args.appId}/qa`);
+            break;
+        // Tasks (existing)
         case "vibekit_submit_task":
             result = await apiRequest("POST", "/task", {
                 task: args.task,
@@ -263,6 +641,7 @@ async function handleTool(name, args) {
         case "vibekit_delete_schedule":
             result = await apiRequest("DELETE", `/schedule/${args.scheduleId}`);
             break;
+        // Account
         case "vibekit_account":
             result = await apiRequest("GET", "/account");
             break;
@@ -327,7 +706,7 @@ async function handleTool(name, args) {
 // Main server setup
 const server = new index_js_1.Server({
     name: "vibekit-mcp",
-    version: "0.1.0",
+    version: "0.4.0",
 }, {
     capabilities: {
         tools: {},

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "vibekit-mcp",
-  "version": "0.2.0",
-  "description": "MCP server for VibeKit — use AI coding tasks as native tools in Claude Desktop, Cursor, etc.",
+  "version": "0.4.0",
+  "description": "MCP server for VibeKit — deploy apps, manage hosting, chat with AI agents, and run coding tasks from Claude Desktop, Cursor, and other MCP clients.",
   "main": "dist/index.js",
   "bin": {
     "vibekit-mcp": "./dist/index.js"
@@ -17,11 +17,12 @@
   "keywords": [
     "mcp",
     "vibekit",
-    "claude",
-    "ai",
+    "deploy",
+    "hosting",
+    "ai-agent",
     "coding",
-    "tools",
-    "anthropic"
+    "cursor",
+    "claude-desktop"
   ],
   "author": "609.sol",
   "license": "MIT",
@@ -38,4 +39,4 @@
     "@types/node": "^20.0.0",
     "typescript": "^5.0.0"
   }
-}
+}