@tupaas/mcp 1.0.0 → 1.1.1

package/dist/index.js

@@ -8,12 +8,15 @@ import os from "os";
 import { execSync } from "child_process";
 const API_URL = process.env.TUPAAS_API_URL ?? "https://tupaas.dev/api";
 const API_KEY = process.env.TUPAAS_API_KEY ?? "";
-const server = new Server({ name: "tupaas-mcp", version: "1.0.0" }, { capabilities: { tools: {} } });
+const server = new Server({ name: "tupaas-mcp", version: "1.1.0" }, { capabilities: { tools: {} } });
+function authHeaders() {
+    return { "x-api-key": API_KEY };
+}
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: [
         {
             name: "deploy",
-            description: "Deploy a project folder to TuPaaS. Compresses the folder, uploads it, and returns the live URL.",
+            description: "Deploy a project folder to TuPaaS. Compresses the folder, uploads it, and returns the live URL. Supports redeploy (same name = update existing project). IMPORTANT: If the project requires a database (e.g. has prisma, pg, DATABASE_URL in .env), call list_databases first and ask the user which database to use or whether to create a new one. Do not decide on your own.",
             inputSchema: {
                 type: "object",
                 properties: {
@@ -23,7 +26,12 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                     },
                     app_name: {
                         type: "string",
-                        description: "Name for the app (optional, inferred from directory name)",
+                        description: "Name for the app (optional, inferred from directory name). Use the same name to redeploy/update an existing project.",
+                    },
+                    env_vars: {
+                        type: "object",
+                        description: "Environment variables to set on the app (e.g. {\"DATABASE_URL\": \"postgres://...\"}). These are saved and persist across deploys.",
+                        additionalProperties: { type: "string" },
                     },
                 },
                 required: ["project_path"],
@@ -43,6 +51,42 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                 required: ["deploy_id"],
             },
         },
+        {
+            name: "list_databases",
+            description: "List all databases owned by the authenticated user. Returns id, name, type, status, and connection URL for each database. IMPORTANT: If this is called as part of a deploy process and the project needs a database, you MUST present the list to the user and ask whether they want to use one of these existing databases or create a new one. Never choose automatically.",
+            inputSchema: {
+                type: "object",
+                properties: {},
+            },
+        },
+        {
+            name: "create_database",
+            description: "Create a new PostgreSQL database. Returns the database id, name, and internal connection URL. Use this URL as DATABASE_URL env var when deploying.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    name: {
+                        type: "string",
+                        description: "Name for the database (lowercase, alphanumeric and hyphens only)",
+                    },
+                },
+                required: ["name"],
+            },
+        },
+        {
+            name: "get_database",
+            description: "Get details of a specific database including its connection URL.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    database_id: {
+                        type: "string",
+                        description: "The database ID",
+                    },
+                },
+                required: ["database_id"],
+            },
+        },
     ],
 }));
 server.setRequestHandler(CallToolRequestSchema, async (request) => {
@@ -51,7 +95,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             content: [
                 {
                     type: "text",
-                    text: "Error: TUPAAS_API_KEY environment variable not set. Get your key from https://tupaas.dev/dashboard/api-keys",
+                    text: "Error: TUPAAS_API_KEY environment variable not set. Get your key from your TuPaaS dashboard under API Keys.",
                 },
             ],
         };
@@ -61,7 +105,6 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             const args = request.params.arguments;
             const projectPath = args.project_path;
             const appName = args.app_name ?? path.basename(projectPath);
-            // Validate path exists
             if (!fs.existsSync(projectPath)) {
                 return {
                     content: [
@@ -72,10 +115,10 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     ],
                 };
             }
-            // Compress as ZIP (server expects ZIP format)
-            const tarPath = path.join(os.tmpdir(), `${appName}.zip`);
+            // Compress as ZIP
+            const zipPath = path.join(os.tmpdir(), `${appName}.zip`);
             try {
-                execSync(`cd "${projectPath}" && zip -r "${tarPath}" . -x 'node_modules/*' '.git/*' '.next/*' 'dist/*'`);
+                execSync(`cd "${projectPath}" && zip -r "${zipPath}" . -x 'node_modules/*' '.git/*' '.next/*' 'dist/*'`);
             }
             catch {
                 return {
@@ -87,9 +130,9 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     ],
                 };
             }
-            const stats = fs.statSync(tarPath);
+            const stats = fs.statSync(zipPath);
             if (stats.size > 50 * 1024 * 1024) {
-                fs.unlinkSync(tarPath);
+                fs.unlinkSync(zipPath);
                 return {
                     content: [
                         {
@@ -100,25 +143,30 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 };
             }
             // Upload
-            const fileBuffer = fs.readFileSync(tarPath);
+            const fileBuffer = fs.readFileSync(zipPath);
             const formData = new FormData();
             formData.append("file", new Blob([fileBuffer]), `${appName}.zip`);
             formData.append("name", appName);
+            if (args.env_vars && Object.keys(args.env_vars).length > 0) {
+                formData.append("env_vars", JSON.stringify(args.env_vars));
+            }
             const res = await fetch(`${API_URL}/deploy`, {
                 method: "POST",
-                headers: { "x-api-key": API_KEY },
+                headers: authHeaders(),
                 body: formData,
             });
-            fs.unlinkSync(tarPath);
+            fs.unlinkSync(zipPath);
             if (!res.ok) {
-                const err = (await res.json());
+                let errorMsg = `Deploy failed (${res.status})`;
+                try {
+                    const err = (await res.json());
+                    errorMsg = `Deploy failed: ${err.error}`;
+                }
+                catch {
+                    /* response not JSON */
+                }
                 return {
-                    content: [
-                        {
-                            type: "text",
-                            text: `Deploy failed: ${err.error}`,
-                        },
-                    ],
+                    content: [{ type: "text", text: errorMsg }],
                 };
             }
             const result = (await res.json());
@@ -129,7 +177,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             const maxPolls = 120;
             for (let i = 0; i < maxPolls; i++) {
                 await new Promise((r) => setTimeout(r, 5000));
-                const statusRes = await fetch(`${API_URL}/deploys/${result.deployId}/status`, { headers: { "x-api-key": API_KEY } });
+                const statusRes = await fetch(`${API_URL}/deploys/${result.deployId}/status`, { headers: authHeaders() });
                 if (!statusRes.ok)
                     break;
                 const status = (await statusRes.json());
@@ -156,7 +204,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     content: [
                         {
                             type: "text",
-                            text: `Deploy failed with status: ${finalStatus}\n\nDeploy ID: ${result.deployId}\nProject: ${result.projectSlug}\n\n--- Build Logs ---\n${lastLogs || "No logs available"}\n\n--- End Logs ---\nDashboard: http://localhost:3000/dashboard/projects/${result.projectSlug}`,
+                            text: `Deploy ended with status: ${finalStatus}\n\nDeploy ID: ${result.deployId}\nProject: ${result.projectSlug}\n\n--- Build Logs ---\n${lastLogs || "No logs available"}\n\n--- End Logs ---`,
                         },
                     ],
                 };
@@ -164,7 +212,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         }
         case "deploy_status": {
             const args = request.params.arguments;
-            const res = await fetch(`${API_URL}/deploys/${args.deploy_id}/status`, { headers: { "x-api-key": API_KEY } });
+            const res = await fetch(`${API_URL}/deploys/${args.deploy_id}/status`, { headers: authHeaders() });
             if (!res.ok) {
                 return {
                     content: [
@@ -176,11 +224,103 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 };
             }
             const data = (await res.json());
+            return {
+                content: [
+                    { type: "text", text: JSON.stringify(data, null, 2) },
+                ],
+            };
+        }
+        case "list_databases": {
+            const res = await fetch(`${API_URL}/databases`, {
+                headers: authHeaders(),
+            });
+            if (!res.ok) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Error: Could not list databases (${res.status})`,
+                        },
+                    ],
+                };
+            }
+            const databases = (await res.json());
+            if (databases.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: "No databases found. Use create_database to create one.",
+                        },
+                    ],
+                };
+            }
+            const list = databases
+                .map((db) => `- ${db.name} (${db.type}, ${db.status})\n  ID: ${db.id}\n  URL: ${db.internalDbUrl ?? "hidden"}`)
+                .join("\n\n");
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Databases:\n\n${list}`,
+                    },
+                ],
+            };
+        }
+        case "create_database": {
+            const args = request.params.arguments;
+            const res = await fetch(`${API_URL}/databases`, {
+                method: "POST",
+                headers: {
+                    ...authHeaders(),
+                    "Content-Type": "application/json",
+                },
+                body: JSON.stringify({ name: args.name }),
+            });
+            if (!res.ok) {
+                let errorMsg = `Failed to create database (${res.status})`;
+                try {
+                    const err = (await res.json());
+                    errorMsg = `Failed to create database: ${err.error}`;
+                }
+                catch {
+                    /* response not JSON */
+                }
+                return {
+                    content: [{ type: "text", text: errorMsg }],
+                };
+            }
+            const database = (await res.json());
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Database created!\n\nName: ${database.name}\nID: ${database.id}\nConnection URL: ${database.internalDbUrl}\n\nUse this URL as DATABASE_URL when deploying:\n  deploy(env_vars: {"DATABASE_URL": "${database.internalDbUrl}"})`,
+                    },
+                ],
+            };
+        }
+        case "get_database": {
+            const args = request.params.arguments;
+            const res = await fetch(`${API_URL}/databases/${args.database_id}`, {
+                headers: authHeaders(),
+            });
+            if (!res.ok) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Error: Could not fetch database (${res.status})`,
+                        },
+                    ],
+                };
+            }
+            const database = (await res.json());
             return {
                 content: [
                     {
                         type: "text",
-                        text: JSON.stringify(data, null, 2),
+                        text: `Database: ${database.name}\nType: ${database.type}\nStatus: ${database.status}\nConnection URL: ${database.internalDbUrl}\n\nUse as DATABASE_URL in deploy env_vars.`,
                     },
                 ],
             };

package/package.json

@@ -1,12 +1,14 @@
 {
   "name": "@tupaas/mcp",
-  "version": "1.0.0",
+  "version": "1.1.1",
   "description": "MCP server for deploying to TuPaaS from Claude Code",
   "type": "module",
   "bin": {
     "tupaas-mcp": "./dist/index.js"
   },
-  "files": ["dist/"],
+  "files": [
+    "dist/"
+  ],
   "engines": {
     "node": ">=18.0.0"
   },