@synth-coder/memhub 0.1.3 → 0.1.5

package/README.md

@@ -72,7 +72,7 @@ Example MCP client config:
       "command": "npx",
       "args": ["-y", "@synth-coder/memhub"],
       "env": {
-        "MEMHUB_STORAGE_PATH": "/absolute/path/to/memories",
+        "MEMHUB_STORAGE_PATH": "/absolute/path/to/.memhub",
         "MEMHUB_LOG_LEVEL": "info"
       }
     }
@@ -97,7 +97,7 @@ Example MCP client config:
 
 ## Environment Variables
 
-- `MEMHUB_STORAGE_PATH` (default: `./memories`)
+- `MEMHUB_STORAGE_PATH` (default: `~/.memhub`)
 - `MEMHUB_LOG_LEVEL` (default: `info`, options: `debug|info|warn|error`)
 
 ---

package/README.zh-CN.md

@@ -97,7 +97,7 @@ npx -y @synth-coder/memhub
 
 ## 环境变量
 
-- `MEMHUB_STORAGE_PATH`：记忆存储目录（默认：`./memories`）
+- `MEMHUB_STORAGE_PATH`：记忆存储目录（默认：`~/.memhub`）
 - `MEMHUB_LOG_LEVEL`：日志级别（默认：`info`，可选：`debug|info|warn|error`）
 
 ---

package/dist/src/contracts/mcp.d.ts

@@ -1,6 +1,6 @@
 /**
  * MCP (Model Context Protocol) specific types and constants
- * Defines the protocol structures for stdio-based communication
+ * Tool definitions and business-level types (protocol types provided by SDK)
  */
 import type { Memory } from './types.js';
 /** Current MCP protocol version */
@@ -10,74 +10,6 @@ export declare const SERVER_INFO: {
     readonly name: "memhub";
     readonly version: "0.1.0";
 };
-/** JSON-RPC request ID */
-export type RequestId = string | number;
-/** Base JSON-RPC request structure */
-export interface JsonRpcRequest<T = unknown> {
-    jsonrpc: '2.0';
-    id?: RequestId;
-    method: string;
-    params?: T;
-}
-/** Base JSON-RPC response structure */
-export interface JsonRpcResponse<T = unknown> {
-    jsonrpc: '2.0';
-    id: RequestId | null;
-    result?: T;
-    error?: JsonRpcError;
-}
-/** JSON-RPC error structure */
-export interface JsonRpcError {
-    code: number;
-    message: string;
-    data?: unknown;
-}
-/** JSON-RPC notification (no response expected) */
-export interface JsonRpcNotification<T = unknown> {
-    jsonrpc: '2.0';
-    method: string;
-    params?: T;
-}
-/** Initialize request parameters */
-export interface InitializeParams {
-    protocolVersion: string;
-    capabilities: ClientCapabilities;
-    clientInfo: Implementation;
-}
-/** Initialize result */
-export interface InitializeResult {
-    protocolVersion: string;
-    capabilities: ServerCapabilities;
-    serverInfo: Implementation;
-}
-/** Implementation information */
-export interface Implementation {
-    name: string;
-    version: string;
-}
-/** Client capabilities */
-export interface ClientCapabilities {
-    readonly experimental?: Record<string, unknown>;
-    readonly roots?: {
-        listChanged?: boolean;
-    };
-    readonly sampling?: Record<string, unknown>;
-}
-/** Server capabilities */
-export interface ServerCapabilities {
-    readonly experimental?: Record<string, unknown>;
-    readonly logging?: Record<string, unknown>;
-    readonly prompts?: {
-        listChanged?: boolean;
-    };
-    readonly resources?: {
-        subscribe?: boolean;
-        listChanged?: boolean;
-    };
-    readonly tools?: {
-        listChanged?: boolean;
-    };
-}
 /** Tool definition for tool/list */
 export interface Tool {
     name: string;
@@ -91,54 +23,12 @@ export interface ToolInputSchema {
     required?: string[];
     additionalProperties?: boolean;
 }
-/** Tool call request */
-export interface ToolCallRequest {
-    name: string;
-    arguments?: Record<string, unknown>;
-}
-/** Tool call result */
-export interface ToolCallResult {
-    content: ToolContent[];
-    isError?: boolean;
-}
-/** Tool content types */
-export type ToolContent = TextContent | ImageContent;
-/** Text content */
-export interface TextContent {
-    type: 'text';
-    text: string;
-}
-/** Image content */
-export interface ImageContent {
-    type: 'image';
-    data: string;
-    mimeType: string;
-}
 /** All available tool names */
 export declare const TOOL_NAMES: readonly ["memory_load", "memory_update"];
 /** Tool name type */
 export type ToolName = (typeof TOOL_NAMES)[number];
 /** Tool definitions for MCP server */
 export declare const TOOL_DEFINITIONS: readonly Tool[];
-/** All MCP method names */
-export declare const MCP_METHODS: {
-    readonly INITIALIZE: "initialize";
-    readonly INITIALIZED: "notifications/initialized";
-    readonly SHUTDOWN: "shutdown";
-    readonly EXIT: "exit";
-    readonly TOOLS_LIST: "tools/list";
-    readonly TOOLS_CALL: "tools/call";
-    readonly LOGGING_MESSAGE: "notifications/message";
-    readonly PROGRESS: "notifications/progress";
-};
-/** Standard JSON-RPC error codes */
-export declare const JSONRPC_ERROR_CODES: {
-    readonly PARSE_ERROR: -32700;
-    readonly INVALID_REQUEST: -32600;
-    readonly METHOD_NOT_FOUND: -32601;
-    readonly INVALID_PARAMS: -32602;
-    readonly INTERNAL_ERROR: -32603;
-};
 /** MemHub custom error codes */
 export declare const MEMHUB_ERROR_CODES: {
     readonly NOT_FOUND: -32001;
@@ -146,7 +36,7 @@ export declare const MEMHUB_ERROR_CODES: {
     readonly VALIDATION_ERROR: -32003;
     readonly DUPLICATE_ERROR: -32004;
 };
-/** Combined error codes */
+/** Combined error codes (includes JSON-RPC standard codes) */
 export declare const ERROR_CODES: {
     readonly NOT_FOUND: -32001;
     readonly STORAGE_ERROR: -32002;

package/dist/src/contracts/mcp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../../src/contracts/mcp.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../../src/contracts/mcp.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAMzC,mCAAmC;AACnC,eAAO,MAAM,oBAAoB,eAAe,CAAC;AAEjD,yBAAyB;AACzB,eAAO,MAAM,WAAW;;;CAGd,CAAC;AAMX,oCAAoC;AACpC,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,eAAe,CAAC;CAC9B;AAED,sCAAsC;AACtC,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAMD,+BAA+B;AAC/B,eAAO,MAAM,UAAU,2CAA4C,CAAC;AAEpE,qBAAqB;AACrB,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD,sCAAsC;AACtC,eAAO,MAAM,gBAAgB,EAAE,SAAS,IAAI,EAmDlC,CAAC;AAMX,gCAAgC;AAChC,eAAO,MAAM,kBAAkB;;;;;CAKrB,CAAC;AAEX,8DAA8D;AAC9D,eAAO,MAAM,WAAW;;;;;;;;;;CAOd,CAAC;AAMX,0DAA0D;AAC1D,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,QAAQ,IAAI,CAAC,SAAS,aAAa,GAChE;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAClC,CAAC,SAAS,eAAe,GACvB;IACE,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB,GACD,KAAK,CAAC;AAEZ,yDAAyD;AACzD,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,QAAQ,IAAI,CAAC,SAAS,aAAa,GAC/D;IACE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;CACvB,GACD,CAAC,SAAS,eAAe,GACvB;IACE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC3B,SAAS,CAAC,EAAE,UAAU,GAAG,YAAY,GAAG,WAAW,GAAG,MAAM,GAAG,cAAc,CAAC;IAC9E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GACD,KAAK,CAAC"}

package/dist/src/contracts/mcp.js

@@ -1,6 +1,6 @@
 /**
  * MCP (Model Context Protocol) specific types and constants
- * Defines the protocol structures for stdio-based communication
+ * Tool definitions and business-level types (protocol types provided by SDK)
  */
 // ============================================================================
 // MCP Protocol Version
@@ -69,34 +69,8 @@ export const TOOL_DEFINITIONS = [
     },
 ];
 // ============================================================================
-// MCP Methods
+// Error Codes (MemHub Custom)
 // ============================================================================
-/** All MCP method names */
-export const MCP_METHODS = {
-    // Lifecycle
-    INITIALIZE: 'initialize',
-    INITIALIZED: 'notifications/initialized',
-    SHUTDOWN: 'shutdown',
-    EXIT: 'exit',
-    // Tools
-    TOOLS_LIST: 'tools/list',
-    TOOLS_CALL: 'tools/call',
-    // Logging
-    LOGGING_MESSAGE: 'notifications/message',
-    // Progress
-    PROGRESS: 'notifications/progress',
-};
-// ============================================================================
-// Error Codes (Standard MCP + Custom)
-// ============================================================================
-/** Standard JSON-RPC error codes */
-export const JSONRPC_ERROR_CODES = {
-    PARSE_ERROR: -32700,
-    INVALID_REQUEST: -32600,
-    METHOD_NOT_FOUND: -32601,
-    INVALID_PARAMS: -32602,
-    INTERNAL_ERROR: -32603,
-};
 /** MemHub custom error codes */
 export const MEMHUB_ERROR_CODES = {
     NOT_FOUND: -32001,
@@ -104,9 +78,13 @@ export const MEMHUB_ERROR_CODES = {
     VALIDATION_ERROR: -32003,
     DUPLICATE_ERROR: -32004,
 };
-/** Combined error codes */
+/** Combined error codes (includes JSON-RPC standard codes) */
 export const ERROR_CODES = {
-    ...JSONRPC_ERROR_CODES,
+    PARSE_ERROR: -32700,
+    INVALID_REQUEST: -32600,
+    METHOD_NOT_FOUND: -32601,
+    INVALID_PARAMS: -32602,
+    INTERNAL_ERROR: -32603,
     ...MEMHUB_ERROR_CODES,
 };
 //# sourceMappingURL=mcp.js.map

package/dist/src/contracts/mcp.js.map

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

package/dist/src/server/mcp-server.d.ts

@@ -1,81 +1,11 @@
 #!/usr/bin/env node
 /**
  * MCP Server - Model Context Protocol server implementation
- * Communicates via stdio
+ * Uses @modelcontextprotocol/sdk for protocol handling
  */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 /**
- * MCP Server implementation
+ * Create McpServer instance using SDK
  */
-export declare class McpServer {
-    private readonly memoryService;
-    constructor();
-    /**
-     * Starts the MCP server and begins listening for requests on stdin
-     */
-    start(): void;
-    /**
-     * Handles an incoming JSON-RPC message
-     *
-     * @param message - The JSON-RPC message string
-     */
-    private handleMessage;
-    /**
-     * Handles a specific method call
-     *
-     * @param method - The method name
-     * @param params - The method parameters
-     * @returns The method result
-     */
-    private handleMethod;
-    /**
-     * Handles the initialize method
-     *
-     * @param params - Initialize parameters
-     * @returns Initialize result
-     */
-    private handleInitialize;
-    /**
-     * Handles tool calls
-     *
-     * @param request - Tool call request
-     * @returns Tool call result
-     */
-    private handleToolCall;
-    /**
-     * Handles errors and sends appropriate error response
-     *
-     * @param id - Request ID
-     * @param error - The error that occurred
-     */
-    private handleError;
-    /**
-     * Sends a JSON-RPC response
-     *
-     * @param id - Request ID
-     * @param result - Response result
-     */
-    private sendResponse;
-    /**
-     * Sends a JSON-RPC error
-     *
-     * @param id - Request ID
-     * @param code - Error code
-     * @param message - Error message
-     * @param data - Additional error data
-     */
-    private sendError;
-    /**
-     * Sends a message to stdout
-     *
-     * @param message - The message to send
-     */
-    private sendMessage;
-    /**
-     * Logs a message
-     *
-     * @param level - Log level
-     * @param message - Log message
-     */
-    private log;
-}
+export declare function createMcpServer(): Server;
 //# sourceMappingURL=mcp-server.d.ts.map

package/dist/src/server/mcp-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../../../src/server/mcp-server.ts"],"names":[],"mappings":";AACA;;;GAGG;AA0CH;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;;IAO9C;;OAEG;IACH,KAAK,IAAI,IAAI;IAqCb;;;;OAIG;YACW,aAAa;IAgC3B;;;;;;OAMG;YACW,YAAY;IAkC1B;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IAgBxB;;;;;OAKG;YACW,cAAc;IAoD5B;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IAkBnB;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IASpB;;;;;;;OAOG;IACH,OAAO,CAAC,SAAS;IAqBjB;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAKnB;;;;;OAKG;IACH,OAAO,CAAC,GAAG;CAQZ"}
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../../../src/server/mcp-server.ts"],"names":[],"mappings":";AACA;;;GAGG;AAKH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AA0BnE;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAyFxC"}

package/dist/src/server/mcp-server.js

@@ -1,15 +1,18 @@
 #!/usr/bin/env node
 /**
  * MCP Server - Model Context Protocol server implementation
- * Communicates via stdio
+ * Uses @modelcontextprotocol/sdk for protocol handling
  */
 import { readFileSync } from 'fs';
 import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
-import { MCP_PROTOCOL_VERSION, SERVER_INFO, TOOL_DEFINITIONS, MCP_METHODS, ERROR_CODES, } from '../contracts/mcp.js';
-import { ErrorCode } from '../contracts/types.js';
+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 { MemoryService, ServiceError } from '../services/memory-service.js';
 import { MemoryLoadInputSchema, MemoryUpdateInputV2Schema, } from '../contracts/schemas.js';
+import { TOOL_DEFINITIONS, SERVER_INFO } from '../contracts/mcp.js';
+import { ErrorCode } from '../contracts/types.js';
 // Get package version
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
@@ -17,142 +20,39 @@ const __dirname = dirname(__filename);
 const packageJsonPath = join(__dirname, '../../../package.json');
 const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
 /**
- * MCP Server implementation
+ * Create McpServer instance using SDK
  */
-export class McpServer {
-    memoryService;
-    constructor() {
-        const storagePath = process.env.MEMHUB_STORAGE_PATH || './memories';
-        this.memoryService = new MemoryService({ storagePath });
-    }
-    /**
-     * Starts the MCP server and begins listening for requests on stdin
-     */
-    start() {
-        this.log('info', 'MemHub MCP Server starting...');
-        process.stdin.setEncoding('utf-8');
-        let buffer = '';
-        process.stdin.on('data', (chunk) => {
-            buffer += chunk;
-            // Process complete lines (JSON-RPC messages)
-            const lines = buffer.split('\n');
-            buffer = lines.pop() || ''; // Keep incomplete line in buffer
-            for (const line of lines) {
-                if (line.trim()) {
-                    void this.handleMessage(line.trim());
-                }
-            }
-        });
-        process.stdin.on('end', () => {
-            this.log('info', 'Stdin closed, shutting down...');
-            process.exit(0);
-        });
-        process.on('SIGINT', () => {
-            this.log('info', 'Received SIGINT, shutting down...');
-            process.exit(0);
-        });
-        process.on('SIGTERM', () => {
-            this.log('info', 'Received SIGTERM, shutting down...');
-            process.exit(0);
-        });
-    }
-    /**
-     * Handles an incoming JSON-RPC message
-     *
-     * @param message - The JSON-RPC message string
-     */
-    async handleMessage(message) {
-        let request = null;
-        try {
-            request = JSON.parse(message);
-        }
-        catch {
-            this.sendError(null, ERROR_CODES.PARSE_ERROR, 'Parse error: Invalid JSON');
-            return;
-        }
-        // Validate JSON-RPC request
-        if (request.jsonrpc !== '2.0' || !request.method) {
-            this.sendError(request.id ?? null, ERROR_CODES.INVALID_REQUEST, 'Invalid Request');
-            return;
-        }
-        try {
-            const result = await this.handleMethod(request.method, request.params);
-            // Send response (only for requests with id, not notifications)
-            if (request.id !== undefined) {
-                this.sendResponse(request.id, result);
-            }
-        }
-        catch (error) {
-            this.handleError(request.id ?? null, error);
-        }
-    }
-    /**
-     * Handles a specific method call
-     *
-     * @param method - The method name
-     * @param params - The method parameters
-     * @returns The method result
-     */
-    async handleMethod(method, params) {
-        switch (method) {
-            case MCP_METHODS.INITIALIZE:
-                return this.handleInitialize(params);
-            case MCP_METHODS.INITIALIZED:
-                // Notification, no response needed
-                this.log('info', 'Client initialized');
-                return null;
-            case MCP_METHODS.SHUTDOWN:
-                return null;
-            case MCP_METHODS.EXIT:
-                process.exit(0);
-                return null;
-            case MCP_METHODS.TOOLS_LIST:
-                return { tools: TOOL_DEFINITIONS };
-            case MCP_METHODS.TOOLS_CALL:
-                return this.handleToolCall(params);
-            default:
-                throw new ServiceError(`Method not found: ${method}`, ErrorCode.METHOD_NOT_FOUND);
-        }
-    }
-    /**
-     * Handles the initialize method
-     *
-     * @param params - Initialize parameters
-     * @returns Initialize result
-     */
-    handleInitialize(params) {
-        this.log('info', `Client initializing: ${params.clientInfo.name} v${params.clientInfo.version}`);
-        return {
-            protocolVersion: MCP_PROTOCOL_VERSION,
-            capabilities: {
-                tools: { listChanged: false },
-                logging: {},
-            },
-            serverInfo: {
-                name: SERVER_INFO.name,
-                version: packageJson.version || SERVER_INFO.version,
-            },
-        };
-    }
-    /**
-     * Handles tool calls
-     *
-     * @param request - Tool call request
-     * @returns Tool call result
-     */
-    async handleToolCall(request) {
-        const { name, arguments: args } = request;
+export function createMcpServer() {
+    const storagePath = process.env.MEMHUB_STORAGE_PATH || './memories';
+    const memoryService = new MemoryService({ storagePath });
+    // Create server using SDK
+    const server = new Server({
+        name: SERVER_INFO.name,
+        version: packageJson.version || SERVER_INFO.version,
+    }, {
+        capabilities: {
+            tools: { listChanged: false },
+            logging: {},
+        },
+    });
+    // Handle tools/list request
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        return { tools: TOOL_DEFINITIONS };
+    });
+    // Handle tools/call request
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
         try {
             let result;
             switch (name) {
                 case 'memory_load': {
                     const input = MemoryLoadInputSchema.parse(args ?? {});
-                    result = await this.memoryService.memoryLoad(input);
+                    result = await memoryService.memoryLoad(input);
                     break;
                 }
                 case 'memory_update': {
                     const input = MemoryUpdateInputV2Schema.parse(args ?? {});
-                    result = await this.memoryService.memoryUpdate(input);
+                    result = await memoryService.memoryUpdate(input);
                     break;
                 }
                 default:
@@ -179,88 +79,34 @@ export class McpServer {
                     isError: true,
                 };
             }
-            // Re-throw for generic error handling
+            if (error instanceof Error && error.name === 'ZodError') {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({ error: `Invalid parameters: ${error.message}` }, null, 2),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            // Re-throw for SDK error handling
             throw error;
         }
-    }
-    /**
-     * Handles errors and sends appropriate error response
-     *
-     * @param id - Request ID
-     * @param error - The error that occurred
-     */
-    handleError(id, error) {
-        if (error instanceof ServiceError) {
-            this.sendError(id, error.code, error.message, error.data);
-        }
-        else if (error instanceof Error && error.name === 'ZodError') {
-            this.sendError(id, ERROR_CODES.INVALID_PARAMS, `Invalid parameters: ${error.message}`);
-        }
-        else {
-            this.sendError(id, ERROR_CODES.INTERNAL_ERROR, `Internal error: ${error instanceof Error ? error.message : 'Unknown error'}`);
-        }
-    }
-    /**
-     * Sends a JSON-RPC response
-     *
-     * @param id - Request ID
-     * @param result - Response result
-     */
-    sendResponse(id, result) {
-        const response = {
-            jsonrpc: '2.0',
-            id,
-            result,
-        };
-        this.sendMessage(response);
-    }
-    /**
-     * Sends a JSON-RPC error
-     *
-     * @param id - Request ID
-     * @param code - Error code
-     * @param message - Error message
-     * @param data - Additional error data
-     */
-    sendError(id, code, message, data) {
-        const error = {
-            code,
-            message,
-            data,
-        };
-        const response = {
-            jsonrpc: '2.0',
-            id: id ?? null,
-            error,
-        };
-        this.sendMessage(response);
-    }
-    /**
-     * Sends a message to stdout
-     *
-     * @param message - The message to send
-     */
-    sendMessage(message) {
-        const json = JSON.stringify(message);
-        process.stdout.write(json + '\n');
-    }
-    /**
-     * Logs a message
-     *
-     * @param level - Log level
-     * @param message - Log message
-     */
-    log(level, message) {
-        const logLevel = process.env.MEMHUB_LOG_LEVEL || 'info';
-        const levels = { debug: 0, info: 1, warn: 2, error: 3 };
-        if (levels[level] >= levels[logLevel]) {
-            console.error(`[${level.toUpperCase()}] ${message}`);
-        }
-    }
+    });
+    return server;
 }
-// Start server if this file is run directly
-if (import.meta.url === `file://${process.argv[1]}`) {
-    const server = new McpServer();
-    server.start();
+/**
+ * Start the MCP server
+ */
+async function main() {
+    const server = createMcpServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('MemHub MCP Server running on stdio');
 }
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});
 //# sourceMappingURL=mcp-server.js.map