# MCP Memory Server

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

## Overview

This repository contains a reference implementation of the [Model Context Protocol](https://modelcontextprotocol.io/) Memory Server. The server implements a knowledge graph-based persistent memory system that enables 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

```bash
npm install
npm run build
```

## Usage

```bash
# Run the memory server
npx mcp-server-memory
```

## Development

```bash
npm run watch
```

This will start the server in development mode with automatic rebuilding on file changes.

## Running the Server

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

```bash
# 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:

```bash
npx mcp-server-memory
```

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

## Testing with MCP Inspector

The [MCP Inspector](https://modelcontextprotocol.io/docs/tools/inspector) is an excellent tool for testing and debugging your memory server during development:

### Start the Inspector

```bash
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:

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

Or if published to npm:

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

## Model Context Protocol

The Model Context Protocol (MCP) is an open standard that enables seamless integration between AI applications and external data sources and tools. Learn more at [modelcontextprotocol.io](https://modelcontextprotocol.io/).

## License

MIT