claude-cognitive 0.1.0

package/dist/mcp/server.js

@@ -0,0 +1,277 @@
+/**
+ * MCP server implementation for claude-cognitive.
+ * @module mcp/server
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import express from "express";
+import { randomUUID } from "node:crypto";
+import { handleRecall, handleReflect } from "./handlers.js";
+import { TOOL_DEFINITIONS, recallInputSchema, reflectInputSchema, } from "./tools.js";
+// ============================================
+// Constants
+// ============================================
+/** Default server configuration */
+const DEFAULTS = {
+    name: "claude-cognitive",
+    version: "0.1.0",
+    httpPort: 3000,
+    httpHost: "127.0.0.1",
+    sessionTimeout: 30 * 60 * 1000, // 30 minutes
+};
+// ============================================
+// Server Class
+// ============================================
+/**
+ * ClaudeMindMcpServer wraps the MCP SDK and provides memory tools.
+ *
+ * Supports both STDIO and HTTP transports for flexible deployment:
+ * - STDIO: For local CLI integration with Claude Code
+ * - HTTP: For remote/networked deployments and testing
+ *
+ * @example
+ * ```typescript
+ * const mind = new Mind({ projectPath: '/path/to/project' });
+ * await mind.init();
+ *
+ * const server = new ClaudeMindMcpServer({
+ *   mind,
+ *   transport: 'stdio',
+ * });
+ *
+ * await server.start();
+ * ```
+ */
+export class ClaudeMindMcpServer {
+    mind;
+    transportType;
+    serverName;
+    serverVersion;
+    httpConfig;
+    mcpServer = null;
+    httpServer = null;
+    expressApp = null;
+    running = false;
+    constructor(options) {
+        this.mind = options.mind;
+        this.transportType = options.transport ?? "stdio";
+        this.serverName = options.name ?? DEFAULTS.name;
+        this.serverVersion = options.version ?? DEFAULTS.version;
+        this.httpConfig = {
+            port: options.http?.port ?? DEFAULTS.httpPort,
+            host: options.http?.host ?? DEFAULTS.httpHost,
+            cors: options.http?.cors ?? false,
+            sessionTimeout: options.http?.sessionTimeout ?? DEFAULTS.sessionTimeout,
+        };
+    }
+    /**
+     * Start the MCP server.
+     *
+     * @throws {Error} If server is already running
+     */
+    async start() {
+        if (this.running) {
+            throw new Error("MCP server is already running");
+        }
+        // Create and configure MCP server
+        this.mcpServer = new McpServer({
+            name: this.serverName,
+            version: this.serverVersion,
+        });
+        // Register tools
+        this.registerTools();
+        // Connect transport
+        if (this.transportType === "stdio") {
+            await this.startStdioTransport();
+        }
+        else {
+            await this.startHttpTransport();
+        }
+        this.running = true;
+    }
+    /**
+     * Stop the MCP server.
+     */
+    async stop() {
+        if (!this.running)
+            return;
+        if (this.httpServer) {
+            await new Promise((resolve, reject) => {
+                this.httpServer.close((err) => {
+                    if (err)
+                        reject(err);
+                    else
+                        resolve();
+                });
+            });
+            this.httpServer = null;
+            this.expressApp = null;
+        }
+        this.mcpServer = null;
+        this.running = false;
+    }
+    /**
+     * Check if the server is running.
+     */
+    isRunning() {
+        return this.running;
+    }
+    /**
+     * Get the transport type.
+     */
+    getTransportType() {
+        return this.transportType;
+    }
+    /**
+     * Get the HTTP port (only relevant for HTTP transport).
+     */
+    getHttpPort() {
+        return this.httpConfig.port;
+    }
+    /**
+     * Get the HTTP host (only relevant for HTTP transport).
+     */
+    getHttpHost() {
+        return this.httpConfig.host;
+    }
+    /**
+     * Register memory tools with the MCP server.
+     */
+    registerTools() {
+        if (!this.mcpServer)
+            return;
+        // Register memory_recall
+        this.mcpServer.tool(TOOL_DEFINITIONS.memory_recall.name, TOOL_DEFINITIONS.memory_recall.description, {
+            query: recallInputSchema.shape.query,
+            type: recallInputSchema.shape.type,
+        }, async (args) => {
+            const input = {
+                query: args.query,
+                ...(args.type ? { type: args.type } : {}),
+            };
+            const result = await handleRecall(this.mind, input);
+            return {
+                content: result.content,
+                ...(result.isError ? { isError: result.isError } : {}),
+            };
+        });
+        // Register memory_reflect
+        this.mcpServer.tool(TOOL_DEFINITIONS.memory_reflect.name, TOOL_DEFINITIONS.memory_reflect.description, {
+            query: reflectInputSchema.shape.query,
+        }, async (args) => {
+            const result = await handleReflect(this.mind, {
+                query: args.query,
+            });
+            return {
+                content: result.content,
+                ...(result.isError ? { isError: result.isError } : {}),
+            };
+        });
+    }
+    /**
+     * Start STDIO transport.
+     */
+    async startStdioTransport() {
+        const transport = new StdioServerTransport();
+        await this.mcpServer.connect(transport);
+        // Log to stderr (not stdout, which is used for MCP)
+        console.error(`${this.serverName} MCP server started (STDIO transport, v${this.serverVersion})`);
+    }
+    /**
+     * Start HTTP transport with Express.
+     *
+     * Note: The MCP SDK's StreamableHTTPServerTransport is still experimental.
+     * For now, we implement a simple JSON-RPC endpoint.
+     */
+    async startHttpTransport() {
+        this.expressApp = express();
+        this.expressApp.use(express.json());
+        // Optional CORS
+        if (this.httpConfig.cors) {
+            this.expressApp.use((_req, res, next) => {
+                res.header("Access-Control-Allow-Origin", "*");
+                res.header("Access-Control-Allow-Methods", "GET, POST, DELETE, OPTIONS");
+                res.header("Access-Control-Allow-Headers", "Content-Type, mcp-session-id");
+                if (_req.method === "OPTIONS") {
+                    res.sendStatus(200);
+                    return;
+                }
+                next();
+            });
+        }
+        // Health check endpoint
+        this.expressApp.get("/health", (_req, res) => {
+            res.json({
+                status: "ok",
+                server: this.serverName,
+                version: this.serverVersion,
+                degraded: this.mind.isDegraded,
+            });
+        });
+        // Tools listing endpoint (for debugging)
+        this.expressApp.get("/tools", (_req, res) => {
+            res.json({
+                tools: [
+                    {
+                        name: TOOL_DEFINITIONS.memory_recall.name,
+                        description: TOOL_DEFINITIONS.memory_recall.description,
+                    },
+                    {
+                        name: TOOL_DEFINITIONS.memory_reflect.name,
+                        description: TOOL_DEFINITIONS.memory_reflect.description,
+                    },
+                ],
+            });
+        });
+        // Tool execution endpoint (simple JSON-RPC style)
+        this.expressApp.post("/tools/:name", async (req, res) => {
+            const toolName = req.params.name;
+            const sessionId = req.headers["mcp-session-id"] || randomUUID();
+            try {
+                if (toolName === "memory_recall") {
+                    const parsed = recallInputSchema.safeParse(req.body);
+                    if (!parsed.success) {
+                        res.status(400).json({
+                            error: "Invalid input",
+                            details: parsed.error.errors,
+                        });
+                        return;
+                    }
+                    const input = {
+                        query: parsed.data.query,
+                        ...(parsed.data.type ? { type: parsed.data.type } : {}),
+                    };
+                    const result = await handleRecall(this.mind, input);
+                    res.json({ sessionId, ...result });
+                }
+                else if (toolName === "memory_reflect") {
+                    const parsed = reflectInputSchema.safeParse(req.body);
+                    if (!parsed.success) {
+                        res.status(400).json({
+                            error: "Invalid input",
+                            details: parsed.error.errors,
+                        });
+                        return;
+                    }
+                    const result = await handleReflect(this.mind, parsed.data);
+                    res.json({ sessionId, ...result });
+                }
+                else {
+                    res.status(404).json({ error: `Unknown tool: ${toolName}` });
+                }
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : "Unknown error";
+                res.status(500).json({ error: message });
+            }
+        });
+        // Start listening
+        await new Promise((resolve) => {
+            this.httpServer = this.expressApp.listen(this.httpConfig.port, this.httpConfig.host, () => {
+                console.error(`${this.serverName} MCP server started (HTTP transport, v${this.serverVersion}) at http://${this.httpConfig.host}:${this.httpConfig.port}`);
+                resolve();
+            });
+        });
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

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

package/dist/mcp/tools.d.ts

@@ -0,0 +1,59 @@
+/**
+ * MCP tool definitions with Zod schemas.
+ * @module mcp/tools
+ */
+import { z } from "zod";
+/**
+ * Zod schema for memory_recall tool input.
+ */
+export declare const recallInputSchema: z.ZodObject<{
+    query: z.ZodString;
+    type: z.ZodOptional<z.ZodEnum<["world", "experience", "opinion", "all"]>>;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+    type?: "world" | "experience" | "opinion" | "all" | undefined;
+}, {
+    query: string;
+    type?: "world" | "experience" | "opinion" | "all" | undefined;
+}>;
+/**
+ * Zod schema for memory_reflect tool input.
+ */
+export declare const reflectInputSchema: z.ZodObject<{
+    query: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+}, {
+    query: string;
+}>;
+/**
+ * Tool definitions for MCP server registration.
+ */
+export declare const TOOL_DEFINITIONS: {
+    readonly memory_recall: {
+        readonly name: "memory_recall";
+        readonly description: "Search project memories for relevant context. Use when you want to remember something from previous sessions or find information about the project. Returns memories matching your query, sorted by relevance.";
+        readonly inputSchema: z.ZodObject<{
+            query: z.ZodString;
+            type: z.ZodOptional<z.ZodEnum<["world", "experience", "opinion", "all"]>>;
+        }, "strip", z.ZodTypeAny, {
+            query: string;
+            type?: "world" | "experience" | "opinion" | "all" | undefined;
+        }, {
+            query: string;
+            type?: "world" | "experience" | "opinion" | "all" | undefined;
+        }>;
+    };
+    readonly memory_reflect: {
+        readonly name: "memory_reflect";
+        readonly description: "Reason about what you know and form opinions. Use when you want to think about patterns, make judgments based on experience, or synthesize accumulated knowledge. Returns reasoned insights with confidence scores.";
+        readonly inputSchema: z.ZodObject<{
+            query: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            query: string;
+        }, {
+            query: string;
+        }>;
+    };
+};
+//# sourceMappingURL=tools.d.ts.map

package/dist/mcp/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;EAM5B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;EAE7B,CAAC;AAMH;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;CAanB,CAAC"}

package/dist/mcp/tools.js

@@ -0,0 +1,43 @@
+/**
+ * MCP tool definitions with Zod schemas.
+ * @module mcp/tools
+ */
+import { z } from "zod";
+// ============================================
+// Input Schemas
+// ============================================
+/**
+ * Zod schema for memory_recall tool input.
+ */
+export const recallInputSchema = z.object({
+    query: z.string().min(1).describe("What to search for in memory"),
+    type: z
+        .enum(["world", "experience", "opinion", "all"])
+        .optional()
+        .describe("Type of memory to search (optional, defaults to all)"),
+});
+/**
+ * Zod schema for memory_reflect tool input.
+ */
+export const reflectInputSchema = z.object({
+    query: z.string().min(1).describe("What to think about or reason through"),
+});
+// ============================================
+// Tool Definitions
+// ============================================
+/**
+ * Tool definitions for MCP server registration.
+ */
+export const TOOL_DEFINITIONS = {
+    memory_recall: {
+        name: "memory_recall",
+        description: "Search project memories for relevant context. Use when you want to remember something from previous sessions or find information about the project. Returns memories matching your query, sorted by relevance.",
+        inputSchema: recallInputSchema,
+    },
+    memory_reflect: {
+        name: "memory_reflect",
+        description: "Reason about what you know and form opinions. Use when you want to think about patterns, make judgments based on experience, or synthesize accumulated knowledge. Returns reasoned insights with confidence scores.",
+        inputSchema: reflectInputSchema,
+    },
+};
+//# sourceMappingURL=tools.js.map

package/dist/mcp/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,+CAA+C;AAC/C,gBAAgB;AAChB,+CAA+C;AAE/C;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IACjE,IAAI,EAAE,CAAC;SACJ,IAAI,CAAC,CAAC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;SAC/C,QAAQ,EAAE;SACV,QAAQ,CAAC,sDAAsD,CAAC;CACpE,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,uCAAuC,CAAC;CAC3E,CAAC,CAAC;AAEH,+CAA+C;AAC/C,mBAAmB;AACnB,+CAA+C;AAE/C;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,aAAa,EAAE;QACb,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,gNAAgN;QAClN,WAAW,EAAE,iBAAiB;KAC/B;IACD,cAAc,EAAE;QACd,IAAI,EAAE,gBAAgB;QACtB,WAAW,EACT,qNAAqN;QACvN,WAAW,EAAE,kBAAkB;KAChC;CACO,CAAC"}

package/dist/mcp/types.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Type definitions for MCP (Model Context Protocol) server.
+ * @module mcp/types
+ */
+import type { Mind } from "../mind.js";
+/**
+ * Transport type for MCP server.
+ */
+export type McpTransportType = "stdio" | "http";
+/**
+ * HTTP transport configuration.
+ */
+export interface HttpTransportConfig {
+    /** Port to listen on (default: 3000) */
+    port?: number;
+    /** Host to bind to (default: "127.0.0.1") */
+    host?: string;
+    /** Enable CORS (default: false) */
+    cors?: boolean;
+    /** Session timeout in milliseconds (default: 30 minutes) */
+    sessionTimeout?: number;
+}
+/**
+ * Options for creating the MCP server.
+ */
+export interface McpServerOptions {
+    /** Mind instance to use for operations */
+    mind: Mind;
+    /** Transport type (default: "stdio") */
+    transport?: McpTransportType;
+    /** HTTP transport configuration (only used when transport is "http") */
+    http?: HttpTransportConfig;
+    /** Server name for MCP identification (default: "claude-cognitive") */
+    name?: string;
+    /** Server version (default: from package.json) */
+    version?: string;
+}
+/**
+ * MCP tool result content item.
+ */
+export interface ToolResultContent {
+    type: "text";
+    text: string;
+}
+/**
+ * Tool result format for MCP responses.
+ */
+export interface ToolResult {
+    content: ToolResultContent[];
+    isError?: boolean;
+}
+/**
+ * Recall tool input schema type.
+ */
+export interface RecallToolInput {
+    query: string;
+    type?: "world" | "experience" | "opinion" | "all";
+}
+/**
+ * Reflect tool input schema type.
+ */
+export interface ReflectToolInput {
+    query: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/mcp/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/mcp/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAMvC;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,MAAM,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,4DAA4D;IAC5D,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAMD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0CAA0C;IAC1C,IAAI,EAAE,IAAI,CAAC;IACX,wCAAwC;IACxC,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,wEAAwE;IACxE,IAAI,CAAC,EAAE,mBAAmB,CAAC;IAC3B,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAMD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,GAAG,YAAY,GAAG,SAAS,GAAG,KAAK,CAAC;CACnD;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;CACf"}

package/dist/mcp/types.js

@@ -0,0 +1,6 @@
+/**
+ * Type definitions for MCP (Model Context Protocol) server.
+ * @module mcp/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/mcp/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/mcp/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}