MCP Memory Server

A simple memory storage server for Claude using the Model Context Protocol (MCP). Perfect for hobby projects or learning how to build your first MCP server!

This server lets Claude remember things across conversations by storing and retrieving memories with optional tags.

What It Does

Store text memories that Claude can search and retrieve later. Great for:

• Remembering user preferences
• Storing project notes
• Building knowledge bases
• Learning MCP development

Available Tools

• store_memory: Store a memory with optional tags
• retrieve_memories: Search memories by content
• list_memories: Show all stored memories
• delete_memory: Delete a specific memory
• clear_memories: Delete all memories

Quick Start

1. Install & Run

# Clone and setup
git clone https://github.com/imyashkale/mcp-memory-server.git
cd mcp-memory-server
npm install
npm start

Server runs on http://localhost:3000

2. Add to Claude

claude mcp add memory http://localhost:3000/message --transport http

That's it! Claude can now use the memory tools.

Basic Usage

Once connected to Claude, you can:

# Store memories
"Remember that I like both dogs and cats"

# Retrieve memories  
"What do you remember about my pet preferences?"

# List all memories
"Show me all my stored memories"

Development

Run in dev mode (auto-restart)

npm run dev

Project Structure

• index.js - Main server file with MCP tools
• package.json - Dependencies and scripts
• In-memory storage (resets on restart)

Environment Variables

• PORT - Server port (default: 3000)
• LOG_LEVEL - Logging: error, warn, info, debug (default: info)

Memory Format

Each memory contains:

• id - Unique number
• content - The memory text
• tags - Optional categorization tags
• timestamp - When it was created

Docker (Optional)

# Build and run
docker build -t mcp-memory-server .
docker run -d -p 3000:3000 mcp-memory-server

# Add to Claude with Docker
claude mcp add memory --transport http -- http://localhost:3000/message

What's Next?

This is a basic MCP server to get you started. You can extend it by:

• Adding persistent storage (database)
• Adding more search features
• Building a web interface
• Adding authentication

Troubleshooting

Port in use? Change the port:

PORT=3001 npm start
claude mcp add memory http://localhost:3001/message --transport http

Connection issues? Check the server is running:

curl -X POST http://localhost:3000/message -H "Content-Type: application/json" -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}'

Contributing

This is a hobby project, but contributions are welcome! Feel free to:

• Fork the repository
• Create a feature branch
• Make improvements
• Submit a pull request

License

MIT License - feel free to use this project for learning, hobby projects, or commercial use.

Support

• Issues: Open an issue on GitHub for bugs or feature requests
• Questions: Check the MCP documentation or start a discussion
• MCP Resources: Model Context Protocol Docs

Built with Node.js and the official MCP SDK. Perfect for learning MCP development!