klamdo-mcp 1.0.0 → 1.1.0

package/dist/tools.js

@@ -0,0 +1,224 @@
+"use strict";
+/**
+ * Shared tool definitions and implementations for both stdio and HTTP transports.
+ * The apiKey is per-request in HTTP mode, per-process in stdio mode.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TOOLS = exports.BASE_URL = void 0;
+exports.klamdo = klamdo;
+exports.registerHandlers = registerHandlers;
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+exports.BASE_URL = process.env.KLAMDO_BASE_URL ?? "https://klamdo.app";
+async function klamdo(path, apiKey, body) {
+    const res = await fetch(`${exports.BASE_URL}/api/mcp${path}`, {
+        method: body ? "POST" : "GET",
+        headers: {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${apiKey}`
+        },
+        body: body ? JSON.stringify(body) : undefined
+    });
+    if (!res.ok) {
+        const text = await res.text().catch(() => "");
+        if (res.status === 401) {
+            throw new types_js_1.McpError(types_js_1.ErrorCode.InvalidRequest, "Invalid API key. Get your key at https://klamdo.app/profile");
+        }
+        throw new types_js_1.McpError(types_js_1.ErrorCode.InternalError, `Klamdo API error ${res.status}: ${text.slice(0, 200)}`);
+    }
+    return res.json();
+}
+exports.TOOLS = [
+    {
+        name: "generate_image",
+        description: "Generate a 4K identity-locked image using the user's reference photo on Klamdo. " +
+            "Returns a job ID — use check_job to poll for the result. Costs 3 credits.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                prompt: {
+                    type: "string",
+                    description: "Describe the content you want to generate. Be specific about setting, mood, style, and purpose."
+                },
+                aspectRatio: {
+                    type: "string",
+                    enum: ["1:1", "16:9", "9:16"],
+                    description: "Output aspect ratio. Default: 1:1 (square).",
+                    default: "1:1"
+                }
+            },
+            required: ["prompt"]
+        }
+    },
+    {
+        name: "generate_video",
+        description: "Generate a 5-second vertical identity-locked video from the user's reference photo on Klamdo. " +
+            "Returns a job ID — use check_job to poll. Aspect ratio locked to 9:16. Costs 6 credits.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                prompt: {
+                    type: "string",
+                    description: "Describe the video content with motion cues for best results."
+                }
+            },
+            required: ["prompt"]
+        }
+    },
+    {
+        name: "check_job",
+        description: "Check the status of a Klamdo generation job. Returns status and download URLs when complete.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                jobId: { type: "string", description: "The job ID returned from generate_image or generate_video" }
+            },
+            required: ["jobId"]
+        }
+    },
+    {
+        name: "get_account",
+        description: "Get current Klamdo account status: credit balance, plan, and free sample eligibility.",
+        inputSchema: { type: "object", properties: {} }
+    },
+    {
+        name: "list_jobs",
+        description: "List recent Klamdo generation jobs for this account.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                limit: { type: "number", description: "Maximum jobs to return (default: 10, max: 50)", default: 10 }
+            }
+        }
+    }
+];
+function registerHandlers(server, getApiKey) {
+    server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({ tools: exports.TOOLS }));
+    server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        const input = (args ?? {});
+        const apiKey = getApiKey();
+        if (!apiKey) {
+            throw new types_js_1.McpError(types_js_1.ErrorCode.InvalidRequest, "No API key provided. Set KLAMDO_API_KEY or pass it via Authorization header.");
+        }
+        try {
+            switch (name) {
+                case "generate_image": {
+                    const result = await klamdo("/jobs", apiKey, { prompt: input.prompt, mode: "image", aspectRatio: input.aspectRatio ?? "1:1" });
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `Image generation started.\n\nJob ID: ${result.jobId}\nStatus: ${result.status}\nCredits reserved: ${result.creditsReserved}\n\nUse check_job("${result.jobId}") to get the result. Images typically complete in 30–90 seconds.`
+                            }
+                        ]
+                    };
+                }
+                case "generate_video": {
+                    const result = await klamdo("/jobs", apiKey, { prompt: input.prompt, mode: "video", aspectRatio: "9:16" });
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `Video generation started.\n\nJob ID: ${result.jobId}\nStatus: ${result.status}\nCredits reserved: ${result.creditsReserved}\n\nUse check_job("${result.jobId}") to get the result. Videos typically complete in 2–5 minutes.`
+                            }
+                        ]
+                    };
+                }
+                case "check_job": {
+                    const jobId = String(input.jobId ?? "");
+                    if (!jobId)
+                        throw new types_js_1.McpError(types_js_1.ErrorCode.InvalidParams, "jobId is required");
+                    const result = await klamdo(`/jobs/${jobId}`, apiKey);
+                    if (result.status === "completed") {
+                        const imageAsset = result.assets.find((a) => a.kind === "image");
+                        const videoAsset = result.assets.find((a) => a.kind === "video");
+                        const lines = [
+                            `Job ${jobId} — Completed ✓`,
+                            "",
+                            imageAsset ? `Image URL: ${imageAsset.url}` : null,
+                            videoAsset ? `Video URL: ${videoAsset.url}` : null,
+                            result.caption ? `\nSuggested caption:\n${result.caption}` : null,
+                            "",
+                            `Share page: ${exports.BASE_URL}/share/${jobId}`
+                        ].filter(Boolean);
+                        return { content: [{ type: "text", text: lines.join("\n") }] };
+                    }
+                    if (result.status === "failed") {
+                        return {
+                            content: [
+                                {
+                                    type: "text",
+                                    text: `Job ${jobId} failed: ${result.errorMessage ?? "Unknown error"}. Credits have been refunded.`
+                                }
+                            ]
+                        };
+                    }
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `Job ${jobId} is still running (status: ${result.status}). Check again in 15–30 seconds.`
+                            }
+                        ]
+                    };
+                }
+                case "get_account": {
+                    const result = await klamdo("/account", apiKey);
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: [
+                                    `Klamdo Account: ${result.name} (${result.email})`,
+                                    `Plan: ${result.planTier}`,
+                                    `Credits: ${result.availableCredits}`,
+                                    result.freeSampleEligible ? "Free sample: available" : ""
+                                ].filter(Boolean).join("\n")
+                            }
+                        ]
+                    };
+                }
+                case "list_jobs": {
+                    const limit = Math.min(Number(input.limit ?? 10), 50);
+                    const result = await klamdo(`/jobs?limit=${limit}`, apiKey);
+                    const lines = result.jobs.map((j) => `[${j.status}] ${j.id} — ${j.mode} — "${j.prompt.slice(0, 60)}" (${j.createdAt.slice(0, 10)})`);
+                    return {
+                        content: [{ type: "text", text: lines.length ? lines.join("\n") : "No jobs found." }]
+                    };
+                }
+                default:
+                    throw new types_js_1.McpError(types_js_1.ErrorCode.MethodNotFound, `Unknown tool: ${name}`);
+            }
+        }
+        catch (err) {
+            if (err instanceof types_js_1.McpError)
+                throw err;
+            throw new types_js_1.McpError(types_js_1.ErrorCode.InternalError, err instanceof Error ? err.message : String(err));
+        }
+    });
+    server.setRequestHandler(types_js_1.ListResourcesRequestSchema, async () => ({
+        resources: [
+            {
+                uri: "klamdo://docs",
+                name: "Klamdo API Documentation",
+                description: "How to use Klamdo's MCP tools",
+                mimeType: "text/plain"
+            }
+        ]
+    }));
+    server.setRequestHandler(types_js_1.ReadResourceRequestSchema, async (request) => {
+        if (request.params.uri === "klamdo://docs") {
+            return {
+                contents: [
+                    {
+                        uri: "klamdo://docs",
+                        mimeType: "text/plain",
+                        text: `# Klamdo MCP Server\n\nTools: generate_image, generate_video, check_job, get_account, list_jobs\n\nGet your API key at https://klamdo.app/profile\nPricing: $19.99/mo for 120 credits (3/image, 6/video)\n`
+                    }
+                ]
+            };
+        }
+        throw new types_js_1.McpError(types_js_1.ErrorCode.InvalidRequest, `Resource not found: ${request.params.uri}`);
+    });
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "klamdo-mcp",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "MCP server for Klamdo — AI content generation for coaches and creator-founders. Generate 4K images and 5-second vertical videos from a reference photo via Claude Desktop or any MCP-compatible client.",
   "main": "dist/index.js",
   "bin": {
@@ -9,12 +9,14 @@
   "scripts": {
     "build": "tsc",
     "start": "node dist/index.js",
-    "dev": "ts-node src/index.ts"
+    "start:http": "node dist/http.js",
+    "dev": "ts-node src/index.ts",
+    "dev:http": "ts-node src/http.ts"
   },
   "keywords": ["mcp", "klamdo", "ai-content", "image-generation", "video-generation", "creator-tools"],
   "license": "MIT",
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.0"
+    "@modelcontextprotocol/sdk": "^1.10.0"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",

package/smithery.yaml

@@ -0,0 +1,22 @@
+name: Klamdo — AI Content for Coaches & Creators
+description: |
+  Generate identity-locked 4K images and 5-second vertical videos from a single
+  reference photo. Built for coaches, consultants, and founder-creators who need
+  consistent personal brand content without filming.
+
+  Tools: generate_image, generate_video, check_job, get_account, list_jobs
+
+  Requires a Klamdo API key — get yours free at https://klamdo.app/profile
+
+version: "1.1.0"
+homepage: https://klamdo.app
+documentationUrl: https://klamdo.app/answers
+
+startCommand:
+  type: http
+  url: https://mcp.klamdo.app/mcp
+
+auth:
+  type: bearer
+  label: Klamdo API Key
+  hint: Get your key at https://klamdo.app/profile

package/src/http.ts

@@ -0,0 +1,135 @@
+#!/usr/bin/env node
+/**
+ * Klamdo MCP Server — Streamable HTTP transport
+ *
+ * Runs as a hosted service on mark-mini-s, exposed via Cloudflare Tunnel at:
+ *   https://mcp.klamdo.app
+ *
+ * Each request is stateless. API key is read from Authorization: Bearer <key> header.
+ * Users get their key from https://klamdo.app/profile
+ *
+ * Smithery URL: https://mcp.klamdo.app/mcp
+ */
+
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { createServer, type IncomingMessage, type ServerResponse } from "http";
+import { registerHandlers } from "./tools.js";
+
+const PORT = parseInt(process.env.PORT ?? "3838", 10);
+const HOST = process.env.HOST ?? "127.0.0.1";
+
+function extractApiKey(req: IncomingMessage): string {
+  const auth = req.headers["authorization"] ?? "";
+  if (auth.startsWith("Bearer ")) return auth.slice(7).trim();
+  // Also allow x-api-key header for clients that don't support Bearer
+  const xApiKey = req.headers["x-api-key"];
+  if (typeof xApiKey === "string") return xApiKey.trim();
+  return "";
+}
+
+async function readBody(req: IncomingMessage): Promise<Buffer> {
+  return new Promise((resolve, reject) => {
+    const chunks: Buffer[] = [];
+    req.on("data", (chunk: Buffer) => chunks.push(chunk));
+    req.on("end", () => resolve(Buffer.concat(chunks)));
+    req.on("error", reject);
+  });
+}
+
+function createMcpServer(apiKey: string): Server {
+  const server = new Server(
+    { name: "klamdo", version: "1.1.0" },
+    { capabilities: { tools: {}, resources: {} } }
+  );
+  registerHandlers(server, () => apiKey);
+  return server;
+}
+
+const httpServer = createServer(async (req: IncomingMessage, res: ServerResponse) => {
+  const url = new URL(req.url ?? "/", `http://${req.headers.host}`);
+
+  // Health check
+  if (req.method === "GET" && url.pathname === "/health") {
+    res.writeHead(200, { "Content-Type": "application/json" });
+    res.end(JSON.stringify({ ok: true, service: "klamdo-mcp", version: "1.1.0" }));
+    return;
+  }
+
+  // CORS preflight
+  if (req.method === "OPTIONS") {
+    res.writeHead(204, {
+      "Access-Control-Allow-Origin": "*",
+      "Access-Control-Allow-Methods": "GET, POST, OPTIONS",
+      "Access-Control-Allow-Headers": "Authorization, Content-Type, x-api-key, mcp-session-id"
+    });
+    res.end();
+    return;
+  }
+
+  // MCP endpoint
+  if (url.pathname === "/mcp") {
+    res.setHeader("Access-Control-Allow-Origin", "*");
+    res.setHeader("Access-Control-Allow-Headers", "Authorization, Content-Type, x-api-key, mcp-session-id");
+
+    const apiKey = extractApiKey(req);
+
+    // Require auth — return 401 so Smithery knows OAuth is expected
+    if (!apiKey) {
+      res.writeHead(401, {
+        "Content-Type": "application/json",
+        "WWW-Authenticate": 'Bearer realm="Klamdo MCP", error="missing_token"'
+      });
+      res.end(JSON.stringify({
+        error: "missing_api_key",
+        message: "Get your API key at https://klamdo.app/profile"
+      }));
+      return;
+    }
+
+    try {
+      const body = req.method === "POST" ? await readBody(req) : undefined;
+
+      // Stateless: new server+transport per request
+      const mcpServer = createMcpServer(apiKey);
+      const transport = new StreamableHTTPServerTransport({
+        sessionIdGenerator: undefined // stateless mode
+      });
+
+      await mcpServer.connect(transport);
+
+      await transport.handleRequest(req, res, body ? JSON.parse(body.toString()) : undefined);
+    } catch (err) {
+      if (!res.headersSent) {
+        res.writeHead(500, { "Content-Type": "application/json" });
+        res.end(JSON.stringify({ error: "internal_error", message: String(err) }));
+      }
+    }
+    return;
+  }
+
+  // Root — basic info page
+  if (url.pathname === "/" || url.pathname === "") {
+    res.writeHead(200, { "Content-Type": "application/json" });
+    res.end(JSON.stringify({
+      service: "Klamdo MCP Server",
+      version: "1.1.0",
+      mcpEndpoint: "/mcp",
+      docs: "https://klamdo.app/answers",
+      getApiKey: "https://klamdo.app/profile"
+    }));
+    return;
+  }
+
+  res.writeHead(404, { "Content-Type": "application/json" });
+  res.end(JSON.stringify({ error: "not_found" }));
+});
+
+httpServer.listen(PORT, HOST, () => {
+  process.stdout.write(`[klamdo-mcp:http] Listening on http://${HOST}:${PORT}/mcp\n`);
+});
+
+httpServer.on("error", (err) => {
+  process.stderr.write(`[klamdo-mcp:http] Server error: ${err}\n`);
+  process.exit(1);
+});