MCP Memory Server with MongoDB

This repository contains an MCP (Model Context Protocol) server that provides Claude with memory capabilities through a knowledge graph stored in MongoDB. The server uses a REST API for persistence, allowing the memory to be shared and persisted across sessions.

Features

• Create and manage entities with observations
• Create relationships between entities
• Search through entities and their observations
• Persistent storage through MongoDB
• Full CRUD operations for entities, relations, and observations

Installation

npm install @berwickgeek/mcp-memory-mongo

Configuration

The server requires the following environment variables:

• MEMORY_API_KEY: API key for authentication with the MongoDB API
• MEMORY_API_URL: URL of the MongoDB API server (defaults to http://localhost:3000 if not set)

Usage in MCP Settings

Add the following to your MCP settings file (e.g., cline_mcp_settings.json or claude_desktop_config.json):

{
  "mcpServers": {
    "memory": {
      "command": "node",
      "args": [
        "/path/to/node_modules/@berwickgeek/mcp-memory-mongo/dist/index.js"
      ],
      "env": {
        "MEMORY_API_KEY": "your_api_key_here",
        "MEMORY_API_URL": "https://memory-api-production.up.railway.app"
      }
    }
  }
}

Development

# Install dependencies
npm install

# Build all packages
npm run build

# Watch for changes during development
npm run watch

Available Tools

The server provides the following tools to Claude:

1. create_entities: Create new entities in the knowledge graph
2. create_relations: Create relationships between entities
3. add_observations: Add observations to existing entities
4. delete_entities: Remove entities and their relations
5. delete_observations: Remove specific observations from entities
6. delete_relations: Remove relationships between entities
7. read_graph: Retrieve the entire knowledge graph
8. search_nodes: Search for nodes based on a query
9. open_nodes: Retrieve specific nodes by their names

License

MIT