Memory MCP

A Model Context Protocol server for storing and retrieving memories using low-level Server implementation and SQLite storage.

Installation

This project uses uv for dependency management instead of pip. uv is a fast, reliable Python package installer and resolver.

Install using uv:

Or install directly from source:

For development:

If you don't have uv installed, you can install it following the official instructions.

Usage

Running the server

This will start the MCP server that allows you to store and retrieve memories.

Available Tools

The Memory MCP provides the following tools:

• remember: Store a new memory with a title and content
• get_memory: Retrieve a specific memory by ID or title
• list_memories: List all stored memories
• update_memory: Update an existing memory
• delete_memory: Delete a memory

Debugging with MCP Inspect

MCP provides a handy command-line tool called mcp inspect that allows you to debug and interact with your MCP server directly.

Setup

1. First, make sure the MCP CLI tools are installed:

2. Start the Memory MCP server in one terminal:

3. In another terminal, connect to the running server using mcp inspect:

Using MCP Inspect

Once connected, you can:

List available tools

This will display all the tools provided by the Memory MCP server.

Call a tool

To call a tool, use the call command followed by the tool name and any required arguments:

Debug Mode

You can enable debug mode to see detailed request and response information:

This helps you understand exactly what data is being sent to and received from the server.

Exploring Tool Schemas

To view the schema for a specific tool:

This shows the input schema, required parameters, and description for the tool.

Troubleshooting

If you encounter issues:

1. Check the server logs in the terminal where your server is running for any error messages.
2. In the MCP inspect terminal, enable debug mode with debug on to see raw requests and responses.
3. Ensure the tool parameters match the expected schema (check with the tool command).
4. If the server crashes, check for any uncaught exceptions in the server terminal.

Development

To contribute to the project, install the development dependencies:

Managing Dependencies

This project uses uv.lock file to lock dependencies. To update dependencies:

Running tests

Code formatting

Linting

Type checking