klamdo-mcp 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+/**
+ * Klamdo MCP Server
+ *
+ * Exposes Klamdo's AI content generation to Claude Desktop and other
+ * MCP-compatible clients. Lets AI assistants generate identity-locked
+ * 4K images and 5-second vertical videos on behalf of the user.
+ *
+ * Setup:
+ *   1. Create a Klamdo account at https://klamdo.app
+ *   2. Get your API key from your profile page
+ *   3. Add to Claude Desktop config:
+ *      { "mcpServers": { "klamdo": { "command": "npx", "args": ["klamdo-mcp"], "env": { "KLAMDO_API_KEY": "<your-key>" } } } }
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;GAYG"}

package/dist/index.js

@@ -0,0 +1,303 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * Klamdo MCP Server
+ *
+ * Exposes Klamdo's AI content generation to Claude Desktop and other
+ * MCP-compatible clients. Lets AI assistants generate identity-locked
+ * 4K images and 5-second vertical videos on behalf of the user.
+ *
+ * Setup:
+ *   1. Create a Klamdo account at https://klamdo.app
+ *   2. Get your API key from your profile page
+ *   3. Add to Claude Desktop config:
+ *      { "mcpServers": { "klamdo": { "command": "npx", "args": ["klamdo-mcp"], "env": { "KLAMDO_API_KEY": "<your-key>" } } } }
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const BASE_URL = process.env.KLAMDO_BASE_URL ?? "https://klamdo.app";
+const API_KEY = process.env.KLAMDO_API_KEY ?? "";
+if (!API_KEY) {
+    process.stderr.write("[klamdo-mcp] Warning: KLAMDO_API_KEY is not set. All API calls will fail. " +
+        "Set it in your MCP client config.\n");
+}
+async function klamdo(path, body) {
+    const res = await fetch(`${BASE_URL}/api/mcp${path}`, {
+        method: body ? "POST" : "GET",
+        headers: {
+            "Content-Type": "application/json",
+            "Authorization": `Bearer ${API_KEY}`
+        },
+        body: body ? JSON.stringify(body) : undefined
+    });
+    if (!res.ok) {
+        const text = await res.text().catch(() => "");
+        throw new types_js_1.McpError(types_js_1.ErrorCode.InternalError, `Klamdo API error ${res.status}: ${text.slice(0, 200)}`);
+    }
+    return res.json();
+}
+// ── Tool definitions ─────────────────────────────────────────────────────────
+const 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. " +
+                        "Example: 'A confident coach standing in a modern co-working space, window light, suited, holding a coffee, editorial style'"
+                },
+                aspectRatio: {
+                    type: "string",
+                    enum: ["1:1", "16:9", "9:16"],
+                    description: "Output aspect ratio. Default: 1:1 (square, social-optimized).",
+                    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 for the result. Aspect ratio is locked to 9:16. Costs 6 credits.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                prompt: {
+                    type: "string",
+                    description: "Describe the video content. Include motion cues for best results. " +
+                        "Example: 'A confident entrepreneur walking through a city street, slow zoom, cinematic lighting'"
+                }
+            },
+            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 recent jobs.",
+        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
+                }
+            }
+        }
+    }
+];
+// ── MCP Server ───────────────────────────────────────────────────────────────
+const server = new index_js_1.Server({ name: "klamdo", version: "1.0.0" }, { capabilities: { tools: {}, resources: {} } });
+server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({ tools: TOOLS }));
+server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    const input = (args ?? {});
+    try {
+        switch (name) {
+            case "generate_image": {
+                const result = await klamdo("/jobs", {
+                    prompt: input.prompt,
+                    mode: "image",
+                    aspectRatio: input.aspectRatio ?? "4:5"
+                });
+                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", {
+                    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}`);
+                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: ${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");
+                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}`);
+                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));
+    }
+});
+// Resources: expose the API docs as a readable resource
+server.setRequestHandler(types_js_1.ListResourcesRequestSchema, async () => ({
+    resources: [
+        {
+            uri: "klamdo://docs",
+            name: "Klamdo API Documentation",
+            description: "How to use Klamdo's MCP tools and what each parameter does",
+            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
+
+Klamdo generates identity-locked 4K images and 5-second vertical videos for coaches and creator-founders.
+
+## Tools
+
+### generate_image
+Generate a 4K image from the user's reference photo. Costs 3 credits.
+- prompt (required): Describe the content, setting, mood, and style
+- aspectRatio (optional): "1:1" | "16:9" | "9:16" — default "1:1"
+
+### generate_video
+Generate a 5-second 9:16 vertical video. Costs 6 credits.
+- prompt (required): Describe the video content with motion cues
+
+### check_job
+Poll a generation job for results.
+- jobId (required): Job ID from generate_image or generate_video
+
+### get_account
+Get account status: credits, plan tier, free sample eligibility.
+
+### list_jobs
+List recent jobs.
+- limit (optional): Number of jobs to return (default 10, max 50)
+
+## Pricing
+- $19.99/month for 120 credits
+- 3 credits per 4K image (~40/mo)
+- 6 credits per 5-sec video (~20/mo)
+- Free sample on first sign-up
+
+## Links
+- Sign up: https://klamdo.app/sign-up
+- Pricing: https://klamdo.app/pricing
+`
+                }
+            ]
+        };
+    }
+    throw new types_js_1.McpError(types_js_1.ErrorCode.InvalidRequest, `Resource not found: ${request.params.uri}`);
+});
+// ── Start ────────────────────────────────────────────────────────────────────
+async function main() {
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+    process.stderr.write("[klamdo-mcp] Klamdo MCP server running on stdio\n");
+}
+main().catch((err) => {
+    process.stderr.write(`[klamdo-mcp] Fatal error: ${err}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "klamdo-mcp",
+  "version": "1.0.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": {
+    "klamdo-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "ts-node src/index.ts"
+  },
+  "keywords": ["mcp", "klamdo", "ai-content", "image-generation", "video-generation", "creator-tools"],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.4.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}

package/src/index.ts

@@ -0,0 +1,360 @@
+#!/usr/bin/env node
+/**
+ * Klamdo MCP Server
+ *
+ * Exposes Klamdo's AI content generation to Claude Desktop and other
+ * MCP-compatible clients. Lets AI assistants generate identity-locked
+ * 4K images and 5-second vertical videos on behalf of the user.
+ *
+ * Setup:
+ *   1. Create a Klamdo account at https://klamdo.app
+ *   2. Get your API key from your profile page
+ *   3. Add to Claude Desktop config:
+ *      { "mcpServers": { "klamdo": { "command": "npx", "args": ["klamdo-mcp"], "env": { "KLAMDO_API_KEY": "<your-key>" } } } }
+ */
+
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  CallToolRequestSchema,
+  ErrorCode,
+  ListResourcesRequestSchema,
+  ListToolsRequestSchema,
+  McpError,
+  ReadResourceRequestSchema
+} from "@modelcontextprotocol/sdk/types.js";
+
+const BASE_URL = process.env.KLAMDO_BASE_URL ?? "https://klamdo.app";
+const API_KEY = process.env.KLAMDO_API_KEY ?? "";
+
+if (!API_KEY) {
+  process.stderr.write(
+    "[klamdo-mcp] Warning: KLAMDO_API_KEY is not set. All API calls will fail. " +
+    "Set it in your MCP client config.\n"
+  );
+}
+
+async function klamdo<T>(path: string, body?: Record<string, unknown>): Promise<T> {
+  const res = await fetch(`${BASE_URL}/api/mcp${path}`, {
+    method: body ? "POST" : "GET",
+    headers: {
+      "Content-Type": "application/json",
+      "Authorization": `Bearer ${API_KEY}`
+    },
+    body: body ? JSON.stringify(body) : undefined
+  });
+
+  if (!res.ok) {
+    const text = await res.text().catch(() => "");
+    throw new McpError(
+      ErrorCode.InternalError,
+      `Klamdo API error ${res.status}: ${text.slice(0, 200)}`
+    );
+  }
+
+  return res.json() as Promise<T>;
+}
+
+// ── Tool definitions ─────────────────────────────────────────────────────────
+
+const 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. " +
+            "Example: 'A confident coach standing in a modern co-working space, window light, suited, holding a coffee, editorial style'"
+        },
+        aspectRatio: {
+          type: "string",
+          enum: ["1:1", "16:9", "9:16"],
+          description: "Output aspect ratio. Default: 1:1 (square, social-optimized).",
+          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 for the result. Aspect ratio is locked to 9:16. Costs 6 credits.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        prompt: {
+          type: "string",
+          description:
+            "Describe the video content. Include motion cues for best results. " +
+            "Example: 'A confident entrepreneur walking through a city street, slow zoom, cinematic lighting'"
+        }
+      },
+      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 recent jobs.",
+    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
+        }
+      }
+    }
+  }
+];
+
+// ── MCP Server ───────────────────────────────────────────────────────────────
+
+const server = new Server(
+  { name: "klamdo", version: "1.0.0" },
+  { capabilities: { tools: {}, resources: {} } }
+);
+
+server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));
+
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const { name, arguments: args } = request.params;
+  const input = (args ?? {}) as Record<string, unknown>;
+
+  try {
+    switch (name) {
+      case "generate_image": {
+        const result = await klamdo<{ jobId: string; status: string; creditsReserved: number }>("/jobs", {
+          prompt: input.prompt,
+          mode: "image",
+          aspectRatio: input.aspectRatio ?? "4:5"
+        });
+        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<{ jobId: string; status: string; creditsReserved: number }>("/jobs", {
+          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 McpError(ErrorCode.InvalidParams, "jobId is required");
+
+        const result = await klamdo<{
+          status: string;
+          assets: Array<{ kind: string; url: string }>;
+          errorMessage?: string;
+          caption?: string;
+        }>(`/jobs/${jobId}`);
+
+        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: ${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<{
+          name: string;
+          email: string;
+          availableCredits: number;
+          planTier: string;
+          freeSampleEligible: boolean;
+        }>("/account");
+        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: Array<{ id: string; status: string; mode: string; prompt: string; createdAt: string }> }>(`/jobs?limit=${limit}`);
+        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 McpError(ErrorCode.MethodNotFound, `Unknown tool: ${name}`);
+    }
+  } catch (err) {
+    if (err instanceof McpError) throw err;
+    throw new McpError(
+      ErrorCode.InternalError,
+      err instanceof Error ? err.message : String(err)
+    );
+  }
+});
+
+// Resources: expose the API docs as a readable resource
+server.setRequestHandler(ListResourcesRequestSchema, async () => ({
+  resources: [
+    {
+      uri: "klamdo://docs",
+      name: "Klamdo API Documentation",
+      description: "How to use Klamdo's MCP tools and what each parameter does",
+      mimeType: "text/plain"
+    }
+  ]
+}));
+
+server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+  if (request.params.uri === "klamdo://docs") {
+    return {
+      contents: [
+        {
+          uri: "klamdo://docs",
+          mimeType: "text/plain",
+          text: `# Klamdo MCP Server
+
+Klamdo generates identity-locked 4K images and 5-second vertical videos for coaches and creator-founders.
+
+## Tools
+
+### generate_image
+Generate a 4K image from the user's reference photo. Costs 3 credits.
+- prompt (required): Describe the content, setting, mood, and style
+- aspectRatio (optional): "1:1" | "16:9" | "9:16" — default "1:1"
+
+### generate_video
+Generate a 5-second 9:16 vertical video. Costs 6 credits.
+- prompt (required): Describe the video content with motion cues
+
+### check_job
+Poll a generation job for results.
+- jobId (required): Job ID from generate_image or generate_video
+
+### get_account
+Get account status: credits, plan tier, free sample eligibility.
+
+### list_jobs
+List recent jobs.
+- limit (optional): Number of jobs to return (default 10, max 50)
+
+## Pricing
+- $19.99/month for 120 credits
+- 3 credits per 4K image (~40/mo)
+- 6 credits per 5-sec video (~20/mo)
+- Free sample on first sign-up
+
+## Links
+- Sign up: https://klamdo.app/sign-up
+- Pricing: https://klamdo.app/pricing
+`
+        }
+      ]
+    };
+  }
+  throw new McpError(ErrorCode.InvalidRequest, `Resource not found: ${request.params.uri}`);
+});
+
+// ── Start ────────────────────────────────────────────────────────────────────
+
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  process.stderr.write("[klamdo-mcp] Klamdo MCP server running on stdio\n");
+}
+
+main().catch((err) => {
+  process.stderr.write(`[klamdo-mcp] Fatal error: ${err}\n`);
+  process.exit(1);
+});

package/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "lib": ["ES2020"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}