Simple-Memory-Extension

This MCP server provides a memory extension for agents by offering a simple context item store with namespaces, plus semantic search capabilities. You can store, retrieve, and delete individual context items, organize them under namespaces, and perform semantic lookup to find relevant memories based on meaning rather than exact keys. The server exposes tools such as store_context_item, retrieve_context_item_by_key, delete_context_item, create_namespace, delete_namespace, list_namespaces, list_context_item_keys, and retrieve_context_items_by_semantic_search. Use the provided semantic search to pull in relevant memories or notes when building or refining long-running tasks, and let the agent manage its memory through cursor rules or direct item manipulation as needed.

Prerequisites:

• Node.js and npm installed on your system
• Basic familiarity with running commands in a terminal

Installation steps:

1. Clone the repository or create a project folder for the MCP server
2. Install dependencies

npm install

3. Start the server

npm start

4. Configure the MCP connection in your client or orchestrator to point to the server (for example, http://localhost:3000/sse) and enable the desired trust settings if needed.

Note: The server uses environment variables to configure storage and port. See the .env section below for recommended defaults.

Environment variables and configuration tips:

• DB_PATH controls where the SQLite database is stored. Ensure the directory exists or is writable by the process.
• PORT sets the HTTP server port (default 3000). If you run behind a reverse proxy, adjust accordingly.
• USE_HTTP_SSE selects the transport; set to true to use HTTP SSE, or false to use alternative transport if supported.
• LOG_LEVEL can be debug, info, warn, or error; adjust for your debugging needs. Common issues:
• If the server fails to start due to port in use, choose another port and update PORT accordingly.
• Ensure you have the necessary permissions to read/write the DB_PATH location.

NPM package name (if used as an npm-based deployment): gmacev-simple-memory-extension-mcp-server