@tupaas/mcp 1.2.2 → 1.3.1

package/dist/index.js

@@ -6,18 +6,32 @@ import fs from "fs";
 import path from "path";
 import os from "os";
 import { execSync } from "child_process";
-const VERSION = "1.2.2";
+const VERSION = "1.3.1";
 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: VERSION }, { capabilities: { tools: {} } });
+const CONFIG_FILE = ".tupaas.json";
 function authHeaders() {
     return { "x-api-key": API_KEY };
 }
+function readConfig(projectPath) {
+    const configPath = path.join(projectPath, CONFIG_FILE);
+    try {
+        return JSON.parse(fs.readFileSync(configPath, "utf-8"));
+    }
+    catch {
+        return null;
+    }
+}
+function writeConfig(projectPath, config) {
+    const configPath = path.join(projectPath, CONFIG_FILE);
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n");
+}
+const server = new Server({ name: "tupaas-mcp", version: VERSION }, { capabilities: { tools: {} } });
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: [
         {
             name: "deploy",
-            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.",
+            description: "Deploy a project folder to TuPaaS. Reads .tupaas.json from the project root to determine if this is a redeploy. After a successful deploy, writes/updates .tupaas.json with project info. 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. Before deploying, if no .tupaas.json exists, call list_projects to check if the project already exists to avoid creating duplicates.",
             inputSchema: {
                 type: "object",
                 properties: {
@@ -27,7 +41,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                     },
                     app_name: {
                         type: "string",
-                        description: "Name for the app (optional, inferred from directory name). Use the same name to redeploy/update an existing project.",
+                        description: "Name for the app. If .tupaas.json exists in the project, this is ignored and the saved name is used. Only needed for first deploy.",
                     },
                     env_vars: {
                         type: "object",
@@ -52,6 +66,14 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                 required: ["deploy_id"],
             },
         },
+        {
+            name: "list_projects",
+            description: "List all projects owned by the authenticated user. Returns slug, name, status, subdomain, and last deploy date. Use this before deploying to check if a project already exists — if it does, use the same app_name to redeploy instead of creating a new project.",
+            inputSchema: {
+                type: "object",
+                properties: {},
+            },
+        },
         {
             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.",
@@ -88,6 +110,28 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                 required: ["database_id"],
             },
         },
+        {
+            name: "init",
+            description: "Create or update .tupaas.json config file in a project folder. Use this to link a local project to an existing TuPaaS project.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    project_path: {
+                        type: "string",
+                        description: "Absolute path to the project folder",
+                    },
+                    project_slug: {
+                        type: "string",
+                        description: "Slug of the existing TuPaaS project to link to",
+                    },
+                    database_id: {
+                        type: "string",
+                        description: "Database ID to associate (optional)",
+                    },
+                },
+                required: ["project_path", "project_slug"],
+            },
+        },
         {
             name: "version",
             description: "Returns the current version of the TuPaaS MCP server and the API URL it is configured to use.",
@@ -113,7 +157,6 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         case "deploy": {
             const args = request.params.arguments;
             const projectPath = args.project_path;
-            const appName = args.app_name ?? path.basename(projectPath);
             if (!fs.existsSync(projectPath)) {
                 return {
                     content: [
@@ -124,10 +167,33 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     ],
                 };
             }
+            // Read .tupaas.json config
+            const config = readConfig(projectPath);
+            let appName;
+            if (config?.projectSlug) {
+                // Verify project still exists
+                const projRes = await fetch(`${API_URL}/projects`, {
+                    headers: authHeaders(),
+                });
+                const projects = projRes.ok
+                    ? (await projRes.json())
+                    : [];
+                const exists = projects.some((p) => p.slug === config.projectSlug);
+                if (exists) {
+                    appName = config.appName ?? config.projectSlug;
+                }
+                else {
+                    // Project was deleted — use provided name or directory name
+                    appName = args.app_name ?? path.basename(projectPath);
+                }
+            }
+            else {
+                appName = args.app_name ?? path.basename(projectPath);
+            }
             // Compress as ZIP
             const zipPath = path.join(os.tmpdir(), `${appName}.zip`);
             try {
-                execSync(`cd "${projectPath}" && zip -r "${zipPath}" . -x 'node_modules/*' '.git/*' '.next/*' 'dist/*'`);
+                execSync(`cd "${projectPath}" && zip -r "${zipPath}" . -x 'node_modules/*' '.git/*' '.next/*' 'dist/*' '.tupaas.json'`);
             }
             catch {
                 return {
@@ -179,6 +245,14 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 };
             }
             const result = (await res.json());
+            // Write .tupaas.json
+            const newConfig = {
+                ...config,
+                projectSlug: result.projectSlug,
+                appName,
+                lastDeployId: result.deployId,
+            };
+            writeConfig(projectPath, newConfig);
             // Poll until done
             let finalStatus = "QUEUED";
             let appUrl = result.appUrl;
@@ -198,12 +272,27 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 if (status.done)
                     break;
             }
+            // Check .gitignore suggestion
+            let gitignoreHint = "";
+            const gitignorePath = path.join(projectPath, ".gitignore");
+            try {
+                const gitignore = fs.existsSync(gitignorePath)
+                    ? fs.readFileSync(gitignorePath, "utf-8")
+                    : "";
+                if (!gitignore.includes(".tupaas.json")) {
+                    gitignoreHint =
+                        "\n\nTip: Add .tupaas.json to your .gitignore to avoid committing deploy config.";
+                }
+            }
+            catch {
+                /* ignore */
+            }
             if (finalStatus === "SUCCESS") {
                 return {
                     content: [
                         {
                             type: "text",
-                            text: `Deploy successful!\n\nProject: ${result.projectSlug}\nURL: ${appUrl}\nDeploy ID: ${result.deployId}`,
+                            text: `Deploy successful!\n\nProject: ${result.projectSlug}\nURL: ${appUrl}\nDeploy ID: ${result.deployId}\nConfig saved to: ${CONFIG_FILE}${gitignoreHint}`,
                         },
                     ],
                 };
@@ -213,7 +302,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     content: [
                         {
                             type: "text",
-                            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 ---`,
+                            text: `Deploy FAILED\n\nDeploy ID: ${result.deployId}\nProject: ${result.projectSlug}\nStatus: ${finalStatus}\n\n--- Logs ---\n${lastLogs || "No logs available"}\n--- End Logs ---\n\nAnalyze the logs above to identify the error. Common causes: missing environment variables, wrong start command, port mismatch, or missing dependencies. Fix the issue in the source code and redeploy.`,
                         },
                     ],
                 };
@@ -239,6 +328,43 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 ],
             };
         }
+        case "list_projects": {
+            const res = await fetch(`${API_URL}/projects`, {
+                headers: authHeaders(),
+            });
+            if (!res.ok) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Error: Could not list projects (${res.status})`,
+                        },
+                    ],
+                };
+            }
+            const projects = (await res.json());
+            if (projects.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: "No projects found.",
+                        },
+                    ],
+                };
+            }
+            const list = projects
+                .map((p) => `- ${p.name} (${p.status})\n  Slug: ${p.slug}\n  URL: ${p.subdomain ? `https://${p.subdomain}` : "not deployed"}${p.lastDeployAt ? `\n  Last deploy: ${p.lastDeployAt}` : ""}`)
+                .join("\n\n");
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Projects:\n\n${list}`,
+                    },
+                ],
+            };
+        }
         case "list_databases": {
             const res = await fetch(`${API_URL}/databases`, {
                 headers: authHeaders(),
@@ -334,6 +460,33 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 ],
             };
         }
+        case "init": {
+            const args = request.params.arguments;
+            if (!fs.existsSync(args.project_path)) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Error: Path "${args.project_path}" does not exist`,
+                        },
+                    ],
+                };
+            }
+            const config = {
+                projectSlug: args.project_slug,
+                appName: args.project_slug,
+                ...(args.database_id ? { databaseId: args.database_id } : {}),
+            };
+            writeConfig(args.project_path, config);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Created ${CONFIG_FILE} in ${args.project_path}\n\n${JSON.stringify(config, null, 2)}\n\nThis project is now linked to TuPaaS project "${args.project_slug}". Future deploys will update this project.`,
+                    },
+                ],
+            };
+        }
         case "version": {
             return {
                 content: [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tupaas/mcp",
-  "version": "1.2.2",
+  "version": "1.3.1",
   "description": "MCP server for deploying to TuPaaS from Claude Code",
   "type": "module",
   "bin": {