MCP Memory Server

🚀 MCP Memory Server

A Model Context Protocol (MCP) server implementation that equips Large Language Models with persistent memory capabilities.

🚀 Quick Start

The MCP Memory Server is a reference implementation of the Model Context Protocol Memory Server. It offers a knowledge - graph based persistent memory system, allowing LLMs to store, retrieve, and reason about information across conversations and sessions.

✨ Features

• Knowledge Graph Storage: Persistent graph - based information storage
• Entity Management: Create and manage entities and their relationships
• Semantic Search: Find relevant information using semantic similarity
• Cross - session Memory: Maintain context across different conversations
• Memory Operations: Full CRUD operations for memory management

📦 Installation

npm install
npm run build

💻 Usage Examples

Basic Usage

# Run the memory server
npx mcp-server-memory

Development Mode

npm run watch

This will start the server in development mode, automatically rebuilding when files change.

Running the Server

Direct Execution

For development and testing, you can run the server directly:

# Build first (if not already built)
npm run build

# Run the server
node dist/index.js

Using npm binary

After building, you can use the npm binary name:

npx mcp-server-memory

Background Process

The server runs continuously and communicates via stdio (standard input/output), which is the standard for MCP servers.

📚 Documentation

Testing with MCP Inspector

The MCP Inspector is an excellent tool for testing and debugging your memory server during development:

Start the Inspector

npx @modelcontextprotocol/inspector node dist/index.js

This will:

1. Start a proxy server (typically on 127.0.0.1:6277)
2. Launch the web - based inspector interface (typically at http://127.0.0.1:6274)
3. Provide a session token for authentication

Using the Inspector

The Inspector provides several tabs for testing your server:

• Resources tab: View and test memory resources
• Tools tab: Test memory management tools (create, update, delete entities)
• Prompts tab: Test any prompt templates
• Notifications pane: Monitor server logs and messages

Development Workflow

1. Make changes to src/index.ts
2. Run npm run build to rebuild
3. Start the Inspector: npx @modelcontextprotocol/inspector node dist/index.js
4. Test your changes in the web interface
5. Check the notifications pane for any errors

Integration with MCP Clients

To use this server with MCP clients (like Claude Desktop), add it to your client configuration:

{
  "mcpServers": {
    "memory": {
      "command": "node",
      "args": ["/path/to/your/mcp-memory-server/dist/index.js"]
    }
  }
}

Or if published to npm:

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-memory"]
    }
  }
}

📄 License

This project is licensed under the MIT License.