@psraghuveer/memento-server

Translates incoming MCP (Model Context Protocol) tool call requests into command-registry invocations by parsing MCP schemas and mapping them to registered command handlers. Acts as an adapter layer that converts MCP's standardized tool-calling format into Memento's internal command execution model, enabling LLM clients to invoke Memento commands through the MCP interface without direct knowledge of Memento's command architecture.

Automatically generates MCP tool definitions from Memento command registry schemas by introspecting registered commands and converting their signatures into MCP-compliant tool schemas. Validates incoming MCP tool calls against these schemas before execution, ensuring type safety and argument correctness. Uses schema-based validation to catch malformed requests early and provide detailed error messages that guide clients toward correct invocation patterns.

Persists command execution context and results to a local SQLite database, enabling Memento commands to maintain state across MCP invocations. Stores command history, arguments, and results in structured tables, allowing subsequent commands to query prior execution context without relying on external state stores. Uses SQLite's embedded architecture to provide zero-configuration persistence that works offline and requires no network dependencies.

Maintains execution state across multiple MCP tool calls by storing command results in SQLite and making them available as context for subsequent commands. Implements a context-passing mechanism where each command can query the execution history and use prior results as inputs, enabling multi-step workflows where later commands depend on earlier outputs. Uses SQLite queries to retrieve relevant context without requiring explicit state management from the MCP client.

Manages the startup, runtime, and shutdown lifecycle of the MCP server adapter, including initialization of the SQLite database, registration of command handlers, and cleanup of resources on shutdown. Implements graceful shutdown that flushes pending command executions to SQLite before terminating, preventing data loss. Provides health check endpoints and status reporting for monitoring server availability and command registry state.

Catches command execution errors and formats them as MCP-compliant error responses with appropriate error codes, messages, and context. Distinguishes between schema validation errors, command execution errors, and system errors, providing different error codes and recovery suggestions for each category. Logs errors to both the MCP response and internal logs for debugging and monitoring purposes.