@suzko/mcp-server 0.1.0

package/dist/src/tools/deploy.js

@@ -0,0 +1,468 @@
+import { z } from "zod";
+import { assertSafeSubdomain } from "../security.js";
+// Pending-confirmation store for two-step destructive ops. 30-minute TTL, single-use UUID tokens.
+const pendingConfirmations = new Map();
+const CONFIRM_TTL_MS = 30 * 60 * 1000;
+function createConfirmation(params) {
+    const id = crypto.randomUUID();
+    pendingConfirmations.set(id, {
+        params,
+        expiresAt: Date.now() + CONFIRM_TTL_MS,
+    });
+    return id;
+}
+function consumeConfirmation(id) {
+    const entry = pendingConfirmations.get(id);
+    if (!entry)
+        return null;
+    pendingConfirmations.delete(id);
+    if (Date.now() > entry.expiresAt)
+        return null;
+    return entry.params;
+}
+// Periodically clean expired confirmations
+setInterval(() => {
+    const now = Date.now();
+    for (const [id, entry] of pendingConfirmations) {
+        if (now > entry.expiresAt)
+            pendingConfirmations.delete(id);
+    }
+}, 60_000);
+export function registerDeployTools(server, client) {
+    // 1. List deploy templates
+    server.tool("list_deploy_templates", "List available deployment templates (databases, runtimes, services). Optionally filter by category.", {
+        category: z
+            .string()
+            .optional()
+            .describe("Filter templates by category (e.g. 'database', 'runtime', 'cache')"),
+    }, async ({ category }) => {
+        const params = {};
+        if (category)
+            params.category = category;
+        const res = await client.get("/api/deploy/templates", params);
+        if (!res.success) {
+            return {
+                content: [{ type: "text", text: `Error: ${res.error}` }],
+                isError: true,
+            };
+        }
+        const templates = res.data?.templates ?? [];
+        if (templates.length === 0) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: category
+                            ? `No templates found for category "${category}".`
+                            : "No deployment templates available.",
+                    },
+                ],
+            };
+        }
+        const lines = templates.map((t) => `• **${t.name}** (${t.id})${t.category ? ` [${t.category}]` : ""}${t.description ? ` — ${t.description}` : ""}`);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `**Available Templates (${templates.length}):**\n\n${lines.join("\n")}`,
+                },
+            ],
+        };
+    });
+    // 2. List deploy projects
+    server.tool("list_deploy_projects", "List all of the user's deployed projects with their status and URLs.", {}, async () => {
+        const res = await client.get("/api/deploy/projects");
+        if (!res.success) {
+            return {
+                content: [{ type: "text", text: `Error: ${res.error}` }],
+                isError: true,
+            };
+        }
+        const projects = res.data?.projects ?? [];
+        if (projects.length === 0) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "No deploy projects found. Use `create_deploy_project` to create one.",
+                    },
+                ],
+            };
+        }
+        const lines = projects.map((p) => `• **${p.name}** (${p.id}) — Status: ${p.status}${p.url ? ` | URL: ${p.url}` : ""}${p.tier ? ` | Tier: ${p.tier}` : ""}`);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `**Your Projects (${projects.length}):**\n\n${lines.join("\n")}`,
+                },
+            ],
+        };
+    });
+    // 3. Create deploy project (with confirmation)
+    server.tool("create_deploy_project", "Create a new deployment project. Returns a confirmation preview — use confirm_deploy_project to finalize. This may incur costs depending on the tier.", {
+        name: z.string().describe("Project name"),
+        templateId: z.string().describe("Template ID to deploy (from list_deploy_templates)"),
+        tier: z
+            .enum(["nano", "micro", "small", "medium", "large", "xlarge"])
+            .describe("Resource tier: nano(256MB), micro(512MB), small(1GB), medium(2GB), large(4GB), xlarge(8GB)"),
+        stackId: z
+            .string()
+            .optional()
+            .describe("Stack template ID for multi-service deployments"),
+        subdomain: z
+            .string()
+            .optional()
+            .describe("Custom subdomain for the project"),
+        envVars: z
+            .record(z.string())
+            .optional()
+            .describe("Environment variables to set on the project"),
+    }, async ({ name, templateId, tier, stackId, subdomain, envVars }) => {
+        if (subdomain) {
+            try {
+                assertSafeSubdomain(subdomain);
+            }
+            catch (e) {
+                return {
+                    content: [{ type: "text", text: e instanceof Error ? e.message : String(e) }],
+                    isError: true,
+                };
+            }
+        }
+        const params = {
+            name,
+            templateId,
+            tier,
+        };
+        if (stackId)
+            params.stackId = stackId;
+        if (subdomain)
+            params.subdomain = subdomain;
+        if (envVars)
+            params.envVars = envVars;
+        const confirmationId = createConfirmation(params);
+        const tierDescriptions = {
+            nano: "256MB RAM",
+            micro: "512MB RAM",
+            small: "1GB RAM",
+            medium: "2GB RAM",
+            large: "4GB RAM",
+            xlarge: "8GB RAM",
+        };
+        const preview = [
+            `**Create Deploy Project — Confirmation Required**`,
+            ``,
+            `| Setting | Value |`,
+            `|---------|-------|`,
+            `| Name | ${name} |`,
+            `| Template | ${templateId} |`,
+            `| Tier | ${tier} (${tierDescriptions[tier] ?? tier}) |`,
+            stackId ? `| Stack | ${stackId} |` : null,
+            subdomain ? `| Subdomain | ${subdomain} |` : null,
+            envVars
+                ? `| Env Vars | ${Object.keys(envVars).length} variable(s) |`
+                : null,
+            ``,
+            `⚠️ This will create a new deployment that may incur costs based on your subscription plan.`,
+            ``,
+            `To confirm, call \`confirm_deploy_project\` with confirmation ID:`,
+            `\`${confirmationId}\``,
+            ``,
+            `This confirmation expires in 5 minutes.`,
+        ]
+            .filter(Boolean)
+            .join("\n");
+        return {
+            content: [{ type: "text", text: preview }],
+        };
+    });
+    // 3b. Confirm deploy project creation
+    server.tool("confirm_deploy_project", "Confirm and execute a pending deploy project creation. Use the confirmation ID returned by create_deploy_project.", {
+        confirmationId: z
+            .string()
+            .describe("The confirmation ID from create_deploy_project"),
+    }, async ({ confirmationId }) => {
+        const params = consumeConfirmation(confirmationId);
+        if (!params) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "Confirmation not found or expired. Please run `create_deploy_project` again.",
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const res = await client.post("/api/deploy/projects", params);
+        if (!res.success) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to create project: ${res.error}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const p = res.data?.project;
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: p
+                        ? `✅ Project **${p.name}** created successfully!\n\n- ID: ${p.id}\n- Status: ${p.status}${p.url ? `\n- URL: ${p.url}` : ""}`
+                        : "Project created successfully.",
+                },
+            ],
+        };
+    });
+    // 4. Get deploy project details
+    server.tool("get_deploy_project", "Get full details of a specific deploy project including status, URL, services, domains, and resource usage.", {
+        projectId: z.string().describe("The project ID"),
+    }, async ({ projectId }) => {
+        const res = await client.get(`/api/deploy/projects/${projectId}`);
+        if (!res.success) {
+            return {
+                content: [{ type: "text", text: `Error: ${res.error}` }],
+                isError: true,
+            };
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `**Project Details:**\n\n\`\`\`json\n${JSON.stringify(res.data?.project ?? res.data, null, 2)}\n\`\`\``,
+                },
+            ],
+        };
+    });
+    // 5. Control deploy project (start, stop, restart, delete — delete is two-step)
+    server.tool("control_deploy_project", "Control a deploy project: start, stop, restart, or begin delete. 'delete' returns a confirmation ID — use confirm_delete_deploy_project to actually destroy the project.", {
+        projectId: z.string().min(1).max(128).describe("The project ID"),
+        action: z
+            .enum(["start", "stop", "restart", "delete"])
+            .describe("Action to perform on the project"),
+    }, async ({ projectId, action }) => {
+        if (action === "delete") {
+            const confirmationId = createConfirmation({ projectId, op: "delete_project" });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `**Delete Deploy Project — confirmation required**\n\n` +
+                            `| Field | Value |\n|-------|-------|\n| Project ID | ${projectId} |\n\n` +
+                            `⚠️ This will permanently destroy the project, all deployments, attached volumes, and managed domains. ` +
+                            `It cannot be undone.\n\nCall \`confirm_delete_deploy_project\` with:\n\n\`${confirmationId}\`\n\nExpires in 30 minutes.`,
+                    },
+                ],
+            };
+        }
+        // start, stop, restart map to PUT with status or POST to control endpoint
+        const res = await client.put(`/api/deploy/projects/${projectId}`, { action });
+        if (!res.success) {
+            return {
+                content: [{ type: "text", text: `Error: ${res.error}` }],
+                isError: true,
+            };
+        }
+        const status = res.data?.project?.status ?? action;
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Project ${projectId}: ${action} executed. Current status: ${status}`,
+                },
+            ],
+        };
+    });
+    // 5b. Confirm deploy project deletion
+    server.tool("confirm_delete_deploy_project", "Confirm and execute a pending deploy-project deletion. Pass the confirmation ID returned by control_deploy_project(delete).", {
+        confirmationId: z.string().min(1).max(128).describe("Confirmation ID from control_deploy_project"),
+    }, async ({ confirmationId }) => {
+        const params = consumeConfirmation(confirmationId);
+        if (!params || params.op !== "delete_project" || typeof params.projectId !== "string") {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "Confirmation not found or expired. Call control_deploy_project with action='delete' again.",
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const res = await client.del(`/api/deploy/projects/${params.projectId}`);
+        if (!res.success) {
+            return {
+                content: [{ type: "text", text: `Error: ${res.error}` }],
+                isError: true,
+            };
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `✅ Project ${params.projectId} has been deleted.`,
+                },
+            ],
+        };
+    });
+    // 6. Get deploy logs
+    server.tool("get_deploy_logs", "Get runtime logs from a deploy project's container.", {
+        projectId: z.string().describe("The project ID"),
+        tail: z
+            .number()
+            .optional()
+            .default(100)
+            .describe("Number of log lines to return (default: 100)"),
+        since: z
+            .string()
+            .optional()
+            .describe("Return logs since this timestamp (ISO 8601)"),
+    }, async ({ projectId, tail, since }) => {
+        const params = {};
+        if (tail)
+            params.tail = String(tail);
+        if (since)
+            params.since = since;
+        const res = await client.get(`/api/deploy/projects/${projectId}/logs`, params);
+        if (!res.success) {
+            return {
+                content: [{ type: "text", text: `Error: ${res.error}` }],
+                isError: true,
+            };
+        }
+        const logs = res.data?.logs ?? "(no logs)";
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `**Logs for ${projectId}:**\n\n\`\`\`\n${logs}\n\`\`\``,
+                },
+            ],
+        };
+    });
+    // 7. Get deploy build logs
+    server.tool("get_deploy_build_logs", "Get build output/logs from the last deployment build of a project.", {
+        projectId: z.string().describe("The project ID"),
+    }, async ({ projectId }) => {
+        const res = await client.get(`/api/deploy/projects/${projectId}/build-logs`);
+        if (!res.success) {
+            return {
+                content: [{ type: "text", text: `Error: ${res.error}` }],
+                isError: true,
+            };
+        }
+        const logs = res.data?.logs ?? "(no build logs)";
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `**Build Logs for ${projectId}:**${res.data?.buildId ? ` (build: ${res.data.buildId})` : ""}\n\n\`\`\`\n${logs}\n\`\`\``,
+                },
+            ],
+        };
+    });
+    // 8. Redeploy project
+    server.tool("redeploy_project", "Trigger a redeployment of a deploy project, rebuilding and restarting the container.", {
+        projectId: z.string().describe("The project ID"),
+    }, async ({ projectId }) => {
+        const res = await client.post(`/api/deploy/projects/${projectId}/redeploy`);
+        if (!res.success) {
+            return {
+                content: [{ type: "text", text: `Error: ${res.error}` }],
+                isError: true,
+            };
+        }
+        const d = res.data?.deployment;
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: d
+                        ? `Redeployment triggered for ${projectId}.\n\n- Deployment ID: ${d.id}\n- Status: ${d.status}`
+                        : `Redeployment triggered for ${projectId}.`,
+                },
+            ],
+        };
+    });
+    // 9. Set environment variables
+    server.tool("set_deploy_env", "Set environment variables on a deploy project. Existing variables with the same key will be overwritten.", {
+        projectId: z.string().describe("The project ID"),
+        envVars: z
+            .record(z.string())
+            .describe("Key-value pairs of environment variables to set (e.g. { \"DATABASE_URL\": \"postgres://...\" })"),
+    }, async ({ projectId, envVars }) => {
+        const res = await client.post(`/api/deploy/projects/${projectId}/env`, { envVars });
+        if (!res.success) {
+            return {
+                content: [{ type: "text", text: `Error: ${res.error}` }],
+                isError: true,
+            };
+        }
+        const keys = Object.keys(envVars);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Environment variables set on ${projectId}: ${keys.map((k) => `\`${k}\``).join(", ")}.\n\nNote: You may need to redeploy for changes to take effect.`,
+                },
+            ],
+        };
+    });
+    // 10. Check subdomain availability
+    server.tool("check_subdomain", "Check if a subdomain is available for use with a deploy project.", {
+        subdomain: z
+            .string()
+            .describe("The subdomain to check (e.g. 'my-app')"),
+    }, async ({ subdomain }) => {
+        try {
+            assertSafeSubdomain(subdomain);
+        }
+        catch (e) {
+            return {
+                content: [{ type: "text", text: e instanceof Error ? e.message : String(e) }],
+                isError: true,
+            };
+        }
+        const res = await client.get("/api/deploy/subdomain-check", { subdomain });
+        if (!res.success) {
+            return {
+                content: [{ type: "text", text: `Error: ${res.error}` }],
+                isError: true,
+            };
+        }
+        const available = res.data?.available;
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: available
+                        ? `✅ Subdomain **${subdomain}** is available.`
+                        : `❌ Subdomain **${subdomain}** is already taken. Try a different name.`,
+                },
+            ],
+        };
+    });
+    // 11. Get deploy usage
+    server.tool("get_deploy_usage", "Get the user's deploy usage statistics including project counts, resource consumption, and plan limits.", {}, async () => {
+        const res = await client.get("/api/deploy/usage");
+        if (!res.success) {
+            return {
+                content: [{ type: "text", text: `Error: ${res.error}` }],
+                isError: true,
+            };
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `**Deploy Usage:**\n\n\`\`\`json\n${JSON.stringify(res.data, null, 2)}\n\`\`\``,
+                },
+            ],
+        };
+    });
+}

package/dist/src/tools/dns.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { SuzkoClient } from "../client.js";
+export declare function registerDnsTools(server: McpServer, client: SuzkoClient): void;