readme.md•2.53 kB
# Memory MCP Server
A Model Context Protocol (MCP) server that provides tools for storing, retrieving, and managing memories saved to a local file.
## Features
- Store text memories with optional tags
- Search memories by text or tags
- Retrieve all stored memories
- Delete specific memories
- View tag usage statistics
- Persistent storage in a local JSON file
## Installation
### From Source
1. Clone this repository
2. Install dependencies:
```
npm install
```
3. Build the server:
```
npm run build
```
## Usage
### Running the Server
Run the server with:
```bash
npm start -- [storage-path]
```
Where `storage-path` is the directory where you want to store the memories file (defaults to the current directory).
### Setting up with Claude for Desktop
To use this server with Claude for Desktop:
1. Open your Claude for Desktop configuration file:
- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
2. Add the server configuration:
```json
{
"mcpServers": {
"memory": {
"command": "node",
"args": [
"/path/to/mcp-memory-server/build/index.js",
"/path/to/storage/directory"
]
}
}
}
```
3. Restart Claude for Desktop. You may need to force-quit any running Claude processes for the changes to take effect.
### Available Tools
The server exposes the following tools:
#### `store-memory`
Stores a new memory.
Parameters:
- `content` (string, required): The text content to store
- `tags` (array of strings, optional): Tags to categorize the memory
#### `search-memories`
Searches for memories.
Parameters:
- `searchTerm` (string, optional): Text to search for in the memory content
- `tag` (string, optional): Filter memories by this tag
#### `get-all-memories`
Retrieves all stored memories.
Parameters: None
#### `delete-memory`
Deletes a memory by ID.
Parameters:
- `id` (string, required): ID of the memory to delete
#### `get-tags-summary`
Gets a summary of all used tags.
Parameters: None
## Example Usage in Claude
Here are some example queries to use with Claude:
- "Store this information: The project deadline is March 15, 2025. Tags: work, deadlines"
- "What memories do I have related to work?"
- "Show me all my memories"
- "Delete memory with ID abc123"
- "What tags have I used in my memories?"
## File Structure
The server stores memories in a file named `memories.json` in the specified storage directory.
## License
MIT