@ai_design_agency/sdd-mcp 1.0.0

package/README.md

@@ -0,0 +1,153 @@
+# @ai_design_agency/sdd-mcp
+
+MCP (Model Context Protocol) server for the SDD Platform. Exposes spec, process, and session management as Claude-callable tools.
+
+## Overview
+
+This package is a **thin HTTP client** that translates MCP tool calls into Platform API requests. All business logic, validation, and authorization remain centralized in the Platform API.
+
+```
+Claude Code → MCP Server → Platform API → Database
+```
+
+## Installation
+
+```bash
+npm install @ai_design_agency/sdd-mcp
+```
+
+## Configuration
+
+The MCP server requires two environment variables:
+
+```bash
+SDD_API_URL=https://your-platform-api.example.com
+SDD_API_TOKEN=your-bearer-token
+```
+
+### Claude Code Configuration
+
+Add to your Claude Code MCP settings (`~/.claude/claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "sdd": {
+      "command": "npx",
+      "args": ["@ai_design_agency/sdd-mcp"],
+      "env": {
+        "SDD_API_URL": "https://sdd-api.your-domain.com",
+        "SDD_API_TOKEN": "${SDD_API_TOKEN}"
+      }
+    }
+  }
+}
+```
+
+## Available Tools
+
+### Spec Management
+
+| Tool | Description |
+|------|-------------|
+| `spec_create` | Create a new SDD specification |
+| `spec_get` | Get a spec by ID or spec_number |
+| `spec_update` | Update spec content, section, or status |
+| `spec_list` | List specs with optional filters |
+| `spec_search` | Semantic search across specs |
+
+### Process Management
+
+| Tool | Description |
+|------|-------------|
+| `process_list` | List available processes/workflows |
+| `process_get` | Get process details by ID |
+
+### Session Management
+
+| Tool | Description |
+|------|-------------|
+| `session_start` | Start a new work session for a spec |
+| `session_update` | Update session notes |
+| `session_end` | End a work session |
+
+## Tool Examples
+
+### Create a Spec
+
+```json
+{
+  "tool": "spec_create",
+  "arguments": {
+    "type": "FEA",
+    "title": "User Authentication",
+    "content": "# Feature: User Authentication\n\n## Summary\n..."
+  }
+}
+```
+
+### Search Specs
+
+```json
+{
+  "tool": "spec_search",
+  "arguments": {
+    "query": "authentication login",
+    "type": "FEA",
+    "limit": 5
+  }
+}
+```
+
+### Start a Session
+
+```json
+{
+  "tool": "session_start",
+  "arguments": {
+    "spec_id": "uuid-or-spec-number",
+    "notes": "Starting implementation of auth feature"
+  }
+}
+```
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Run in development mode
+npm run dev
+
+# Build
+npm run build
+
+# Run tests
+npm test
+
+# Type check
+npm run type-check
+```
+
+## Architecture
+
+This MCP server follows the **thin client pattern** established in INV-202512024:
+
+- **No Business Logic**: All validation, authorization, and workflow logic stays in Platform API
+- **Type Safety**: Uses `@ai_design_agency/sdd-core` for shared types
+- **Bearer Token Auth**: Token passed to Platform API in Authorization header
+- **Structured Errors**: API errors translated to MCP-friendly format
+
+## Related Packages
+
+- [`@ai_design_agency/sdd-core`](../sdd-core) - Shared TypeScript types
+
+## Spec Reference
+
+- **Spec ID**: FEA-202601002
+- **Parent Epic**: EPC-202512003 (SDD Future State Design)
+
+---
+
+Built by AIDA

package/dist/client.d.ts

@@ -0,0 +1,55 @@
+import type { PaginatedResponse, Spec, SpecWithScore, Process, Session, CreateSpecRequest, UpdateSpecRequest, ListSpecsQuery, SearchSpecsRequest, CreateSessionRequest, UpdateSessionRequest } from "./types.js";
+/**
+ * HTTP client for the SDD Platform API
+ * This is a thin wrapper - all business logic stays in the Platform API
+ */
+export declare class PlatformClient {
+    private readonly baseUrl;
+    private readonly token;
+    constructor(baseUrl: string, token: string);
+    /**
+     * Make an authenticated request to the Platform API
+     */
+    private request;
+    /**
+     * Create a new spec
+     */
+    createSpec(req: CreateSpecRequest): Promise<Spec>;
+    /**
+     * Get a spec by ID or spec_number
+     */
+    getSpec(id: string): Promise<Spec>;
+    /**
+     * Update a spec
+     */
+    updateSpec(id: string, req: UpdateSpecRequest): Promise<Spec>;
+    /**
+     * List specs with optional filters
+     */
+    listSpecs(query?: ListSpecsQuery): Promise<PaginatedResponse<Spec>>;
+    /**
+     * Semantic search for specs
+     */
+    searchSpecs(req: SearchSpecsRequest): Promise<SpecWithScore[]>;
+    /**
+     * List processes
+     */
+    listProcesses(status?: string): Promise<PaginatedResponse<Process>>;
+    /**
+     * Get a process by ID
+     */
+    getProcess(id: string): Promise<Process>;
+    /**
+     * Start a new session
+     */
+    startSession(req: CreateSessionRequest): Promise<Session>;
+    /**
+     * Update a session
+     */
+    updateSession(id: string, req: UpdateSessionRequest): Promise<Session>;
+    /**
+     * End a session
+     */
+    endSession(id: string, notes?: string): Promise<Session>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAEV,iBAAiB,EACjB,IAAI,EACJ,aAAa,EACb,OAAO,EACP,OAAO,EACP,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,qBAAa,cAAc;IAEvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBADL,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM;IAGhC;;OAEG;YACW,OAAO;IA4BrB;;OAEG;IACG,UAAU,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IASvD;;OAEG;IACG,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQxC;;OAEG;IACG,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IASnE;;OAEG;IACG,SAAS,CAAC,KAAK,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAczE;;OAEG;IACG,WAAW,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAapE;;OAEG;IACG,aAAa,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAOzE;;OAEG;IACG,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAY9C;;OAEG;IACG,YAAY,CAAC,GAAG,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;IAS/D;;OAEG;IACG,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;IAS5E;;OAEG;IACG,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAQ/D"}

package/dist/client.js

@@ -0,0 +1,132 @@
+"use strict";
+// @spec FEA-202601002
+// HTTP client for Platform API
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlatformClient = void 0;
+const errors_js_1 = require("./errors.js");
+/**
+ * HTTP client for the SDD Platform API
+ * This is a thin wrapper - all business logic stays in the Platform API
+ */
+class PlatformClient {
+    baseUrl;
+    token;
+    constructor(baseUrl, token) {
+        this.baseUrl = baseUrl;
+        this.token = token;
+    }
+    /**
+     * Make an authenticated request to the Platform API
+     */
+    async request(method, path, body) {
+        const url = `${this.baseUrl}${path}`;
+        const headers = {
+            Authorization: `Bearer ${this.token}`,
+            "Content-Type": "application/json",
+        };
+        const response = await fetch(url, {
+            method,
+            headers,
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        if (!response.ok) {
+            throw await (0, errors_js_1.createErrorFromResponse)(response);
+        }
+        return response.json();
+    }
+    // ============================================================================
+    // Spec Operations
+    // ============================================================================
+    /**
+     * Create a new spec
+     */
+    async createSpec(req) {
+        const { data } = await this.request("POST", "/api/v1/specs", req);
+        return data;
+    }
+    /**
+     * Get a spec by ID or spec_number
+     */
+    async getSpec(id) {
+        const { data } = await this.request("GET", `/api/v1/specs/${encodeURIComponent(id)}`);
+        return data;
+    }
+    /**
+     * Update a spec
+     */
+    async updateSpec(id, req) {
+        const { data } = await this.request("PATCH", `/api/v1/specs/${encodeURIComponent(id)}`, req);
+        return data;
+    }
+    /**
+     * List specs with optional filters
+     */
+    async listSpecs(query) {
+        const params = new URLSearchParams();
+        if (query?.type)
+            params.set("type", query.type);
+        if (query?.status)
+            params.set("status", query.status);
+        if (query?.parent_epic_id)
+            params.set("parent_epic_id", query.parent_epic_id);
+        if (query?.limit)
+            params.set("limit", String(query.limit));
+        if (query?.offset)
+            params.set("offset", String(query.offset));
+        const queryString = params.toString();
+        const path = queryString ? `/api/v1/specs?${queryString}` : "/api/v1/specs";
+        return this.request("GET", path);
+    }
+    /**
+     * Semantic search for specs
+     */
+    async searchSpecs(req) {
+        const { data } = await this.request("POST", "/api/v1/specs/search", req);
+        return data;
+    }
+    // ============================================================================
+    // Process Operations
+    // ============================================================================
+    /**
+     * List processes
+     */
+    async listProcesses(status) {
+        const path = status
+            ? `/api/v1/processes?status=${encodeURIComponent(status)}`
+            : "/api/v1/processes";
+        return this.request("GET", path);
+    }
+    /**
+     * Get a process by ID
+     */
+    async getProcess(id) {
+        const { data } = await this.request("GET", `/api/v1/processes/${encodeURIComponent(id)}`);
+        return data;
+    }
+    // ============================================================================
+    // Session Operations
+    // ============================================================================
+    /**
+     * Start a new session
+     */
+    async startSession(req) {
+        const { data } = await this.request("POST", "/api/v1/sessions", req);
+        return data;
+    }
+    /**
+     * Update a session
+     */
+    async updateSession(id, req) {
+        const { data } = await this.request("PATCH", `/api/v1/sessions/${encodeURIComponent(id)}`, req);
+        return data;
+    }
+    /**
+     * End a session
+     */
+    async endSession(id, notes) {
+        const { data } = await this.request("POST", `/api/v1/sessions/${encodeURIComponent(id)}/end`, notes ? { notes } : undefined);
+        return data;
+    }
+}
+exports.PlatformClient = PlatformClient;
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,21 @@
+import type { ErrorCode } from "./types.js";
+/**
+ * MCP-friendly error that wraps Platform API errors
+ */
+export declare class McpError extends Error {
+    readonly code: ErrorCode;
+    readonly details?: Record<string, unknown> | undefined;
+    constructor(code: ErrorCode, message: string, details?: Record<string, unknown> | undefined);
+    /**
+     * Format error for MCP response
+     */
+    toMcpError(): {
+        code: string;
+        message: string;
+    };
+}
+/**
+ * Create error from HTTP response
+ */
+export declare function createErrorFromResponse(response: Response): Promise<McpError>;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;aAEf,IAAI,EAAE,SAAS;aAEf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAFjC,IAAI,EAAE,SAAS,EAC/B,OAAO,EAAE,MAAM,EACC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;IAMnD;;OAEG;IACH,UAAU,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;CAMhD;AAQD;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAAC,QAAQ,CAAC,CAcnB"}

package/dist/errors.js

@@ -0,0 +1,42 @@
+"use strict";
+// @spec FEA-202601002
+// MCP error handling
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpError = void 0;
+exports.createErrorFromResponse = createErrorFromResponse;
+/**
+ * MCP-friendly error that wraps Platform API errors
+ */
+class McpError extends Error {
+    code;
+    details;
+    constructor(code, message, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = "McpError";
+    }
+    /**
+     * Format error for MCP response
+     */
+    toMcpError() {
+        return {
+            code: this.code,
+            message: this.message,
+        };
+    }
+}
+exports.McpError = McpError;
+/**
+ * Create error from HTTP response
+ */
+async function createErrorFromResponse(response) {
+    try {
+        const body = (await response.json());
+        return new McpError(body.code || "INTERNAL_ERROR", body.error || response.statusText, body.details);
+    }
+    catch {
+        return new McpError("INTERNAL_ERROR", `HTTP ${response.status}: ${response.statusText}`);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";AAAA,sBAAsB;AACtB,qBAAqB;;;AAqCrB,0DAgBC;AAjDD;;GAEG;AACH,MAAa,QAAS,SAAQ,KAAK;IAEf;IAEA;IAHlB,YACkB,IAAe,EAC/B,OAAe,EACC,OAAiC;QAEjD,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,SAAI,GAAJ,IAAI,CAAW;QAEf,YAAO,GAAP,OAAO,CAA0B;QAGjD,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,UAAU;QACR,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC;IACJ,CAAC;CACF;AAnBD,4BAmBC;AAQD;;GAEG;AACI,KAAK,UAAU,uBAAuB,CAC3C,QAAkB;IAElB,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAqB,CAAC;QACzD,OAAO,IAAI,QAAQ,CACjB,IAAI,CAAC,IAAI,IAAI,gBAAgB,EAC7B,IAAI,CAAC,KAAK,IAAI,QAAQ,CAAC,UAAU,EACjC,IAAI,CAAC,OAAO,CACb,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,QAAQ,CACjB,gBAAgB,EAChB,QAAQ,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,UAAU,EAAE,CAClD,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+export { SddMcpServer } from "./server.js";
+export type { SddMcpServerConfig } from "./server.js";
+export { PlatformClient } from "./client.js";
+export { McpError } from "./errors.js";
+export * from "./types.js";
+//# 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":";AAgCA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+"use strict";
+// @spec FEA-202601002
+// SDD MCP Server entry point
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpError = exports.PlatformClient = exports.SddMcpServer = void 0;
+const server_js_1 = require("./server.js");
+// Configuration from environment variables
+const API_URL = process.env.SDD_API_URL;
+const TOKEN = process.env.SDD_API_TOKEN;
+if (!API_URL) {
+    console.error("Error: SDD_API_URL environment variable is required");
+    process.exit(1);
+}
+if (!TOKEN) {
+    console.error("Error: SDD_API_TOKEN environment variable is required");
+    process.exit(1);
+}
+// Create and start the server
+const server = new server_js_1.SddMcpServer({
+    apiUrl: API_URL,
+    token: TOKEN,
+});
+server.start().catch((error) => {
+    console.error("Failed to start SDD MCP Server:", error);
+    process.exit(1);
+});
+// Re-export for programmatic use
+var server_js_2 = require("./server.js");
+Object.defineProperty(exports, "SddMcpServer", { enumerable: true, get: function () { return server_js_2.SddMcpServer; } });
+var client_js_1 = require("./client.js");
+Object.defineProperty(exports, "PlatformClient", { enumerable: true, get: function () { return client_js_1.PlatformClient; } });
+var errors_js_1 = require("./errors.js");
+Object.defineProperty(exports, "McpError", { enumerable: true, get: function () { return errors_js_1.McpError; } });
+__exportStar(require("./types.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;AACA,sBAAsB;AACtB,6BAA6B;;;;;;;;;;;;;;;;;AAE7B,2CAA2C;AAE3C,2CAA2C;AAC3C,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;AACxC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;AAExC,IAAI,CAAC,OAAO,EAAE,CAAC;IACb,OAAO,CAAC,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACrE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,IAAI,CAAC,KAAK,EAAE,CAAC;IACX,OAAO,CAAC,KAAK,CAAC,uDAAuD,CAAC,CAAC;IACvE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,8BAA8B;AAC9B,MAAM,MAAM,GAAG,IAAI,wBAAY,CAAC;IAC9B,MAAM,EAAE,OAAO;IACf,KAAK,EAAE,KAAK;CACb,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IAC7B,OAAO,CAAC,KAAK,CAAC,iCAAiC,EAAE,KAAK,CAAC,CAAC;IACxD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,iCAAiC;AACjC,yCAA2C;AAAlC,yGAAA,YAAY,OAAA;AAErB,yCAA6C;AAApC,2GAAA,cAAc,OAAA;AACvB,yCAAuC;AAA9B,qGAAA,QAAQ,OAAA;AACjB,6CAA2B"}

package/dist/server.d.ts

@@ -0,0 +1,21 @@
+export interface SddMcpServerConfig {
+    /** Platform API base URL */
+    apiUrl: string;
+    /** Bearer token for API authentication */
+    token: string;
+}
+/**
+ * SDD MCP Server - exposes Platform API operations as Claude tools
+ */
+export declare class SddMcpServer {
+    private server;
+    private client;
+    constructor(config: SddMcpServerConfig);
+    private setupHandlers;
+    private handleToolCall;
+    /**
+     * Start the server with stdio transport
+     */
+    start(): Promise<void>;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AA0BA,MAAM,WAAW,kBAAkB;IACjC,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAiB;gBAEnB,MAAM,EAAE,kBAAkB;IAkBtC,OAAO,CAAC,aAAa;YAyCP,cAAc;IAoC5B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAK7B"}

package/dist/server.js

@@ -0,0 +1,106 @@
+"use strict";
+// @spec FEA-202601002
+// MCP Server implementation
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SddMcpServer = void 0;
+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 client_js_1 = require("./client.js");
+const errors_js_1 = require("./errors.js");
+const index_js_2 = require("./tools/index.js");
+/**
+ * SDD MCP Server - exposes Platform API operations as Claude tools
+ */
+class SddMcpServer {
+    server;
+    client;
+    constructor(config) {
+        this.client = new client_js_1.PlatformClient(config.apiUrl, config.token);
+        this.server = new index_js_1.Server({
+            name: "sdd-mcp",
+            version: "1.0.0",
+        }, {
+            capabilities: {
+                tools: {},
+            },
+        });
+        this.setupHandlers();
+    }
+    setupHandlers() {
+        // List available tools
+        this.server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
+            tools: index_js_2.toolDefinitions,
+        }));
+        // Handle tool calls
+        this.server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
+            const { name, arguments: args } = request.params;
+            try {
+                const result = await this.handleToolCall(name, args || {});
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                };
+            }
+            catch (error) {
+                const message = error instanceof errors_js_1.McpError
+                    ? error.message
+                    : error instanceof Error
+                        ? error.message
+                        : "Unknown error";
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({ success: false, error: message }),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        });
+    }
+    async handleToolCall(name, args) {
+        switch (name) {
+            // Spec tools
+            case "spec_create":
+                return (0, index_js_2.handleSpecCreate)(this.client, args);
+            case "spec_get":
+                return (0, index_js_2.handleSpecGet)(this.client, args);
+            case "spec_update":
+                return (0, index_js_2.handleSpecUpdate)(this.client, args);
+            case "spec_list":
+                return (0, index_js_2.handleSpecList)(this.client, args);
+            case "spec_search":
+                return (0, index_js_2.handleSpecSearch)(this.client, args);
+            // Process tools
+            case "process_list":
+                return (0, index_js_2.handleProcessList)(this.client, args);
+            case "process_get":
+                return (0, index_js_2.handleProcessGet)(this.client, args);
+            // Session tools
+            case "session_start":
+                return (0, index_js_2.handleSessionStart)(this.client, args);
+            case "session_update":
+                return (0, index_js_2.handleSessionUpdate)(this.client, args);
+            case "session_end":
+                return (0, index_js_2.handleSessionEnd)(this.client, args);
+            default:
+                throw new errors_js_1.McpError("VALIDATION_ERROR", `Unknown tool: ${name}`);
+        }
+    }
+    /**
+     * Start the server with stdio transport
+     */
+    async start() {
+        const transport = new stdio_js_1.StdioServerTransport();
+        await this.server.connect(transport);
+        console.error("SDD MCP Server started");
+    }
+}
+exports.SddMcpServer = SddMcpServer;
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AAAA,sBAAsB;AACtB,4BAA4B;;;AAE5B,wEAAmE;AACnE,wEAAiF;AACjF,iEAG4C;AAE5C,2CAA6C;AAC7C,2CAAuC;AACvC,+CAY0B;AAS1B;;GAEG;AACH,MAAa,YAAY;IACf,MAAM,CAAS;IACf,MAAM,CAAiB;IAE/B,YAAY,MAA0B;QACpC,IAAI,CAAC,MAAM,GAAG,IAAI,0BAAc,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QAE9D,IAAI,CAAC,MAAM,GAAG,IAAI,iBAAM,CACtB;YACE,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,OAAO;SACjB,EACD;YACE,YAAY,EAAE;gBACZ,KAAK,EAAE,EAAE;aACV;SACF,CACF,CAAC;QAEF,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;IAEO,aAAa;QACnB,uBAAuB;QACvB,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,iCAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;YACjE,KAAK,EAAE,0BAAe;SACvB,CAAC,CAAC,CAAC;QAEJ,oBAAoB;QACpB,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,gCAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACrE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;YAEjD,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;gBAC3D,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;yBACtC;qBACF;iBACF,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,OAAO,GACX,KAAK,YAAY,oBAAQ;oBACvB,CAAC,CAAC,KAAK,CAAC,OAAO;oBACf,CAAC,CAAC,KAAK,YAAY,KAAK;wBACtB,CAAC,CAAC,KAAK,CAAC,OAAO;wBACf,CAAC,CAAC,eAAe,CAAC;gBAExB,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;yBACzD;qBACF;oBACD,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,cAAc,CAC1B,IAAY,EACZ,IAA6B;QAE7B,QAAQ,IAAI,EAAE,CAAC;YACb,aAAa;YACb,KAAK,aAAa;gBAChB,OAAO,IAAA,2BAAgB,EAAC,IAAI,CAAC,MAAM,EAAE,IAA8C,CAAC,CAAC;YACvF,KAAK,UAAU;gBACb,OAAO,IAAA,wBAAa,EAAC,IAAI,CAAC,MAAM,EAAE,IAA2C,CAAC,CAAC;YACjF,KAAK,aAAa;gBAChB,OAAO,IAAA,2BAAgB,EAAC,IAAI,CAAC,MAAM,EAAE,IAA8C,CAAC,CAAC;YACvF,KAAK,WAAW;gBACd,OAAO,IAAA,yBAAc,EAAC,IAAI,CAAC,MAAM,EAAE,IAA4C,CAAC,CAAC;YACnF,KAAK,aAAa;gBAChB,OAAO,IAAA,2BAAgB,EAAC,IAAI,CAAC,MAAM,EAAE,IAA8C,CAAC,CAAC;YAEvF,gBAAgB;YAChB,KAAK,cAAc;gBACjB,OAAO,IAAA,4BAAiB,EAAC,IAAI,CAAC,MAAM,EAAE,IAA+C,CAAC,CAAC;YACzF,KAAK,aAAa;gBAChB,OAAO,IAAA,2BAAgB,EAAC,IAAI,CAAC,MAAM,EAAE,IAA8C,CAAC,CAAC;YAEvF,gBAAgB;YAChB,KAAK,eAAe;gBAClB,OAAO,IAAA,6BAAkB,EAAC,IAAI,CAAC,MAAM,EAAE,IAAgD,CAAC,CAAC;YAC3F,KAAK,gBAAgB;gBACnB,OAAO,IAAA,8BAAmB,EAAC,IAAI,CAAC,MAAM,EAAE,IAAiD,CAAC,CAAC;YAC7F,KAAK,aAAa;gBAChB,OAAO,IAAA,2BAAgB,EAAC,IAAI,CAAC,MAAM,EAAE,IAA8C,CAAC,CAAC;YAEvF;gBACE,MAAM,IAAI,oBAAQ,CAAC,kBAAkB,EAAE,iBAAiB,IAAI,EAAE,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,MAAM,SAAS,GAAG,IAAI,+BAAoB,EAAE,CAAC;QAC7C,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACrC,OAAO,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC1C,CAAC;CACF;AA3GD,oCA2GC"}