@keeborg/mcp 0.1.0

package/README.md

@@ -0,0 +1,135 @@
+# @keeborg/mcp
+
+MCP (Model Context Protocol) server for [Keeborg](https://www.keeborg.com) - Generate technical specifications for AI coding agents.
+
+## Installation
+
+```bash
+npm install -g @keeborg/mcp
+```
+
+## Setup
+
+### 1. Get your API key
+
+1. Go to [keeborg.com/settings](https://www.keeborg.com/settings)
+2. Create a new API key in the "API Keys" section
+3. Copy the key (starts with `kb_live_`)
+
+### 2. Configure Claude Code
+
+Add to `~/.claude/settings.json`:
+
+```json
+{
+  "mcpServers": {
+    "keeborg": {
+      "command": "keeborg-mcp",
+      "env": {
+        "KEEBORG_API_KEY": "kb_live_your_key_here"
+      }
+    }
+  }
+}
+```
+
+### 3. Configure Cursor
+
+Add to your Cursor MCP settings:
+
+```json
+{
+  "keeborg": {
+    "command": "keeborg-mcp",
+    "env": {
+      "KEEBORG_API_KEY": "kb_live_your_key_here"
+    }
+  }
+}
+```
+
+## Available Tools
+
+### create_project
+
+Create a new project and generate technical specifications.
+
+```
+Arguments:
+- name (required): Short project name
+- description (required): Detailed description of what to build
+- tech_stack (optional): Tech stack preferences
+  - frontend_framework: e.g., "Next.js", "React"
+  - backend_framework: e.g., "FastAPI", "Express"
+  - database: e.g., "PostgreSQL", "Supabase"
+  - etc.
+```
+
+### get_project_status
+
+Check generation progress. Poll until status is "COMPLETED".
+
+```
+Arguments:
+- project_id (required): Project ID from create_project
+```
+
+### get_document
+
+Retrieve a specific specification document.
+
+```
+Arguments:
+- project_id (required): Project ID
+- doc_type (required): One of:
+  - PRD: Product Requirements Document
+  - ARCHITECTURE: System Architecture
+  - API_SPEC: API Specification
+  - DB_SCHEMA: Database Schema
+  - UX_SPEC: UX Specification
+  - UI_SPEC: UI Specification
+  - IMPLEMENTATION_GUIDE: Implementation Guide
+  - AGENT_WORKFLOW: Agent Workflow
+```
+
+### list_projects
+
+List all your projects.
+
+### get_prompts
+
+Get AI-optimized prompts generated from specs.
+
+```
+Arguments:
+- project_id (required): Project ID
+- prompt_type (optional): "primary", "backend", "frontend", "fullstack", "devops", or "testing"
+```
+
+## Example Usage
+
+In Claude Code or Cursor:
+
+```
+User: "I want to build a habit tracking app with React and Supabase"
+
+Agent: [Uses create_project tool]
+       "Project created. Generating specifications..."
+
+       [Polls get_project_status]
+       "Specs ready! Let me get the database schema..."
+
+       [Uses get_document with DB_SCHEMA]
+       "Based on the schema, I'll create these tables..."
+
+       [Proceeds to implement using the specs]
+```
+
+## Requirements
+
+- Node.js 18+
+- Keeborg Pro subscription (for API access)
+
+## License
+
+MIT

package/dist/api.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Keeborg API Client
+ * Wraps the Keeborg REST API for use by the MCP server.
+ */
+export interface Project {
+    id: string;
+    name: string;
+    original_prompt: string;
+    status: "DRAFT" | "REFINING" | "GENERATING" | "COMPLETED" | "FAILED";
+    created_at: string;
+    updated_at: string;
+}
+export interface Document {
+    id: string;
+    project_id: string;
+    doc_type: string;
+    version: number;
+    content: Record<string, unknown>;
+    created_at: string;
+}
+export interface ProjectWithDocs extends Project {
+    documents: Document[];
+}
+export interface PromptSection {
+    title: string;
+    description: string;
+    prompt: string;
+}
+export interface ProjectPrompts {
+    id: string;
+    project_id: string;
+    prompts: Record<string, PromptSection>;
+    created_at: string;
+    updated_at: string;
+}
+export interface TechStackPreferences {
+    frontend_framework?: string;
+    css_styling?: string;
+    backend_framework?: string;
+    database?: string;
+    auth_provider?: string;
+    deployment?: string;
+}
+export declare class KeebergAPI {
+    private apiKey;
+    constructor(apiKey: string);
+    private fetch;
+    /**
+     * Create a new project and start spec generation.
+     */
+    createProject(projectName: string, initialPrompt: string, techStack?: TechStackPreferences): Promise<Project>;
+    /**
+     * Get a project by ID, including all documents.
+     */
+    getProject(projectId: string): Promise<ProjectWithDocs>;
+    /**
+     * List all projects for the current user.
+     */
+    listProjects(): Promise<Project[]>;
+    /**
+     * Get prompts for a project (if generated).
+     */
+    getPrompts(projectId: string): Promise<ProjectPrompts | null>;
+    /**
+     * Generate prompts for a project.
+     */
+    generatePrompts(projectId: string): Promise<ProjectPrompts>;
+    /**
+     * Delete a project.
+     */
+    deleteProject(projectId: string): Promise<void>;
+}
+//# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,OAAO,GAAG,UAAU,GAAG,YAAY,GAAG,WAAW,GAAG,QAAQ,CAAC;IACrE,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAgB,SAAQ,OAAO;IAC9C,SAAS,EAAE,QAAQ,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,MAAM;YAIZ,KAAK;IAkBnB;;OAEG;IACG,aAAa,CACjB,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,EACrB,SAAS,CAAC,EAAE,oBAAoB,GAC/B,OAAO,CAAC,OAAO,CAAC;IAWnB;;OAEG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAI7D;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAIxC;;OAEG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAWnE;;OAEG;IACG,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAMjE;;OAEG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAKtD"}

package/dist/api.js

@@ -0,0 +1,82 @@
+/**
+ * Keeborg API Client
+ * Wraps the Keeborg REST API for use by the MCP server.
+ */
+const API_BASE = "https://api.keeborg.com/api/v1";
+export class KeebergAPI {
+    apiKey;
+    constructor(apiKey) {
+        this.apiKey = apiKey;
+    }
+    async fetch(path, options = {}) {
+        const res = await fetch(`${API_BASE}${path}`, {
+            ...options,
+            headers: {
+                Authorization: `Bearer ${this.apiKey}`,
+                "Content-Type": "application/json",
+                ...options.headers,
+            },
+        });
+        if (!res.ok) {
+            const error = await res.json().catch(() => ({ detail: "Request failed" }));
+            throw new Error(error.detail || `API error: ${res.status}`);
+        }
+        return res.json();
+    }
+    /**
+     * Create a new project and start spec generation.
+     */
+    async createProject(projectName, initialPrompt, techStack) {
+        return this.fetch("/projects", {
+            method: "POST",
+            body: JSON.stringify({
+                project_name: projectName,
+                initial_prompt: initialPrompt,
+                tech_stack: techStack,
+            }),
+        });
+    }
+    /**
+     * Get a project by ID, including all documents.
+     */
+    async getProject(projectId) {
+        return this.fetch(`/projects/${projectId}`);
+    }
+    /**
+     * List all projects for the current user.
+     */
+    async listProjects() {
+        return this.fetch("/projects");
+    }
+    /**
+     * Get prompts for a project (if generated).
+     */
+    async getPrompts(projectId) {
+        try {
+            return await this.fetch(`/projects/${projectId}/prompts`);
+        }
+        catch (e) {
+            if (e instanceof Error && e.message.includes("404")) {
+                return null;
+            }
+            throw e;
+        }
+    }
+    /**
+     * Generate prompts for a project.
+     */
+    async generatePrompts(projectId) {
+        return this.fetch(`/projects/${projectId}/prompts/generate`, {
+            method: "POST",
+        });
+    }
+    /**
+     * Delete a project.
+     */
+    async deleteProject(projectId) {
+        await this.fetch(`/projects/${projectId}`, {
+            method: "DELETE",
+        });
+    }
+}
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,QAAQ,GAAG,gCAAgC,CAAC;AA+ClD,MAAM,OAAO,UAAU;IACb,MAAM,CAAS;IAEvB,YAAY,MAAc;QACxB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAEO,KAAK,CAAC,KAAK,CAAI,IAAY,EAAE,UAAuB,EAAE;QAC5D,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,QAAQ,GAAG,IAAI,EAAE,EAAE;YAC5C,GAAG,OAAO;YACV,OAAO,EAAE;gBACP,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;gBACtC,cAAc,EAAE,kBAAkB;gBAClC,GAAG,OAAO,CAAC,OAAO;aACnB;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAwB,CAAC;YAClG,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,IAAI,cAAc,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QAC9D,CAAC;QAED,OAAO,GAAG,CAAC,IAAI,EAAgB,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CACjB,WAAmB,EACnB,aAAqB,EACrB,SAAgC;QAEhC,OAAO,IAAI,CAAC,KAAK,CAAU,WAAW,EAAE;YACtC,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,YAAY,EAAE,WAAW;gBACzB,cAAc,EAAE,aAAa;gBAC7B,UAAU,EAAE,SAAS;aACtB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,SAAiB;QAChC,OAAO,IAAI,CAAC,KAAK,CAAkB,aAAa,SAAS,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY;QAChB,OAAO,IAAI,CAAC,KAAK,CAAY,WAAW,CAAC,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,SAAiB;QAChC,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,KAAK,CAAiB,aAAa,SAAS,UAAU,CAAC,CAAC;QAC5E,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,YAAY,KAAK,IAAI,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBACpD,OAAO,IAAI,CAAC;YACd,CAAC;YACD,MAAM,CAAC,CAAC;QACV,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CAAC,SAAiB;QACrC,OAAO,IAAI,CAAC,KAAK,CAAiB,aAAa,SAAS,mBAAmB,EAAE;YAC3E,MAAM,EAAE,MAAM;SACf,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CAAC,SAAiB;QACnC,MAAM,IAAI,CAAC,KAAK,CAAC,aAAa,SAAS,EAAE,EAAE;YACzC,MAAM,EAAE,QAAQ;SACjB,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+/**
+ * Keeborg MCP Server
+ *
+ * Allows AI coding agents (Claude Code, Cursor) to generate and retrieve
+ * technical specifications via the Keeborg API.
+ *
+ * Usage:
+ *   KEEBORG_API_KEY=kb_live_xxx keeborg-mcp
+ *
+ * Claude Code config (~/.claude/settings.json):
+ *   {
+ *     "mcpServers": {
+ *       "keeborg": {
+ *         "command": "keeborg-mcp",
+ *         "env": { "KEEBORG_API_KEY": "kb_live_xxx" }
+ *       }
+ *     }
+ *   }
+ */
+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;;;;;;;;;;;;;;;;;;GAkBG"}

package/dist/index.js

@@ -0,0 +1,335 @@
+#!/usr/bin/env node
+/**
+ * Keeborg MCP Server
+ *
+ * Allows AI coding agents (Claude Code, Cursor) to generate and retrieve
+ * technical specifications via the Keeborg API.
+ *
+ * Usage:
+ *   KEEBORG_API_KEY=kb_live_xxx keeborg-mcp
+ *
+ * Claude Code config (~/.claude/settings.json):
+ *   {
+ *     "mcpServers": {
+ *       "keeborg": {
+ *         "command": "keeborg-mcp",
+ *         "env": { "KEEBORG_API_KEY": "kb_live_xxx" }
+ *       }
+ *     }
+ *   }
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { KeebergAPI } from "./api.js";
+// Validate API key
+const apiKey = process.env.KEEBORG_API_KEY;
+if (!apiKey) {
+    console.error("Error: KEEBORG_API_KEY environment variable is required");
+    console.error("");
+    console.error("Get your API key from https://www.keeborg.com/settings");
+    console.error("");
+    console.error("Usage:");
+    console.error("  KEEBORG_API_KEY=kb_live_xxx keeborg-mcp");
+    process.exit(1);
+}
+if (!apiKey.startsWith("kb_live_")) {
+    console.error("Error: Invalid API key format. Keys should start with 'kb_live_'");
+    process.exit(1);
+}
+const api = new KeebergAPI(apiKey);
+// Create MCP server
+const server = new Server({
+    name: "keeborg",
+    version: "0.1.0",
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// Document type descriptions for better agent understanding
+const DOC_TYPES = {
+    PRD: "Product Requirements Document - Features, user stories, acceptance criteria",
+    ARCHITECTURE: "System Architecture - Tech stack, components, NFRs",
+    API_SPEC: "API Specification - Endpoints, request/response schemas",
+    DB_SCHEMA: "Database Schema - Tables, columns, relationships",
+    UX_SPEC: "UX Specification - User flows, states, navigation",
+    UI_SPEC: "UI Specification - Screens, components, design system",
+    IMPLEMENTATION_GUIDE: "Implementation Guide - Security, deployment, testing",
+    AGENT_WORKFLOW: "Agent Workflow - Development phases, tasks, dependencies",
+};
+// List available tools
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: [
+            {
+                name: "create_project",
+                description: "Create a new Keeborg project and generate technical specifications. " +
+                    "Provide a detailed description of the app/product you want to build. " +
+                    "Optionally specify tech stack preferences. " +
+                    "Returns project ID - use get_project_status to monitor generation progress.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        name: {
+                            type: "string",
+                            description: "Short name for the project (e.g., 'Habit Tracker')",
+                        },
+                        description: {
+                            type: "string",
+                            description: "Detailed description of what you want to build. Include key features, target users, and any specific requirements.",
+                        },
+                        tech_stack: {
+                            type: "object",
+                            description: "Optional tech stack preferences",
+                            properties: {
+                                frontend_framework: { type: "string", description: "e.g., 'Next.js', 'React', 'Vue'" },
+                                css_styling: { type: "string", description: "e.g., 'Tailwind CSS', 'CSS Modules'" },
+                                backend_framework: { type: "string", description: "e.g., 'FastAPI', 'Express', 'Django'" },
+                                database: { type: "string", description: "e.g., 'PostgreSQL', 'MongoDB', 'Supabase'" },
+                                auth_provider: { type: "string", description: "e.g., 'Supabase Auth', 'Auth0', 'Clerk'" },
+                                deployment: { type: "string", description: "e.g., 'Vercel', 'AWS', 'Coolify'" },
+                            },
+                        },
+                    },
+                    required: ["name", "description"],
+                },
+            },
+            {
+                name: "get_project_status",
+                description: "Check the status of a project and its document generation progress. " +
+                    "Use this to poll until status is 'COMPLETED'. " +
+                    "Returns status and list of available documents.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        project_id: {
+                            type: "string",
+                            description: "The project ID from create_project",
+                        },
+                    },
+                    required: ["project_id"],
+                },
+            },
+            {
+                name: "get_document",
+                description: "Retrieve a specific specification document from a project. " +
+                    "Available types: PRD, ARCHITECTURE, API_SPEC, DB_SCHEMA, UX_SPEC, UI_SPEC, IMPLEMENTATION_GUIDE, AGENT_WORKFLOW",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        project_id: {
+                            type: "string",
+                            description: "The project ID",
+                        },
+                        doc_type: {
+                            type: "string",
+                            enum: Object.keys(DOC_TYPES),
+                            description: "Type of document to retrieve",
+                        },
+                    },
+                    required: ["project_id", "doc_type"],
+                },
+            },
+            {
+                name: "list_projects",
+                description: "List all your Keeborg projects with their status.",
+                inputSchema: {
+                    type: "object",
+                    properties: {},
+                },
+            },
+            {
+                name: "get_prompts",
+                description: "Get AI agent prompts generated from the project specifications. " +
+                    "These prompts are optimized for different development focuses: " +
+                    "primary (full-stack), backend, frontend, fullstack, devops, testing.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        project_id: {
+                            type: "string",
+                            description: "The project ID",
+                        },
+                        prompt_type: {
+                            type: "string",
+                            enum: ["primary", "backend", "frontend", "fullstack", "devops", "testing"],
+                            description: "Which prompt to retrieve (default: primary)",
+                        },
+                    },
+                    required: ["project_id"],
+                },
+            },
+        ],
+    };
+});
+// Handle tool calls
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        switch (name) {
+            case "create_project": {
+                const { name: projectName, description, tech_stack } = args;
+                const project = await api.createProject(projectName, description, tech_stack);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                project_id: project.id,
+                                name: project.name,
+                                status: project.status,
+                                message: "Project created. Generating specifications... " +
+                                    "Use get_project_status to monitor progress (typically takes 2-3 minutes).",
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
+            case "get_project_status": {
+                const { project_id } = args;
+                const project = await api.getProject(project_id);
+                const documents = project.documents.map((d) => ({
+                    type: d.doc_type,
+                    description: DOC_TYPES[d.doc_type] || d.doc_type,
+                    version: d.version,
+                }));
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                project_id: project.id,
+                                name: project.name,
+                                status: project.status,
+                                documents,
+                                document_count: documents.length,
+                                is_complete: project.status === "COMPLETED",
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
+            case "get_document": {
+                const { project_id, doc_type } = args;
+                const project = await api.getProject(project_id);
+                const doc = project.documents.find((d) => d.doc_type === doc_type);
+                if (!doc) {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `Document type '${doc_type}' not found. Available: ${project.documents.map((d) => d.doc_type).join(", ")}`,
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                doc_type: doc.doc_type,
+                                description: DOC_TYPES[doc.doc_type],
+                                version: doc.version,
+                                content: doc.content,
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
+            case "list_projects": {
+                const projects = await api.listProjects();
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                projects: projects.map((p) => ({
+                                    id: p.id,
+                                    name: p.name,
+                                    status: p.status,
+                                    created_at: p.created_at,
+                                })),
+                                count: projects.length,
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
+            case "get_prompts": {
+                const { project_id, prompt_type = "primary" } = args;
+                const prompts = await api.getPrompts(project_id);
+                if (!prompts) {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: "Prompts not yet generated for this project. The project may still be generating, or prompts haven't been created yet.",
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+                const section = prompts.prompts[prompt_type];
+                if (!section) {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `Prompt type '${prompt_type}' not found. Available: ${Object.keys(prompts.prompts).join(", ")}`,
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                prompt_type,
+                                title: section.title,
+                                description: section.description,
+                                prompt: section.prompt,
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
+            default:
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Unknown tool: ${name}`,
+                        },
+                    ],
+                    isError: true,
+                };
+        }
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error: ${error instanceof Error ? error.message : String(error)}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// Start server
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("Keeborg MCP server running");
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    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,46 @@
+{
+  "name": "@keeborg/mcp",
+  "version": "0.1.0",
+  "description": "MCP server for Keeborg - Generate technical specs for AI coding agents",
+  "type": "module",
+  "bin": {
+    "keeborg-mcp": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "keeborg",
+    "ai",
+    "coding",
+    "specs",
+    "claude",
+    "cursor"
+  ],
+  "author": "Keeborg",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/phillhendry/keeborg.git",
+    "directory": "mcp-server"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}