@manasdb/mcp-server

ManasDB = Memory Layer for AI Agents.

AI agents today lack persistent memory. @manasdb/mcp-server provides a plug-and-play memory layer for MCP-compatible assistants like Claude and Cursor — powered by ManasDB's unique polyglot storage architecture.

With a single MCP server, AI agents can:

• 🧠 Store memories across multiple databases simultaneously

• 🔍 Retrieve context with semantic vector search

• 🗑️ Delete outdated knowledge on demand

No custom integration. No boilerplate. Just one command.

Quick Start

npx @manasdb/mcp-server setup

This drops you into an interactive setup wizard that generates a ready-to-paste claude_desktop_config.json snippet in under 60 seconds.

Architecture

AI Assistant (Claude / Cursor / Any MCP Client)
     │
     │  MCP Protocol (stdio)
     ▼
 @manasdb/mcp-server
     │
     │  Tools: memorize · recall · forget
     ▼
 @manasdb/core  ◄── Embeddings (Transformers / Ollama / Gemini / OpenAI)
     │
 ┌───┴──────────────────┬────────────────────┐
 ▼                      ▼                    ▼
MongoDB             PostgreSQL           Redis / ES
                                         (coming soon)

ManasDB is AI Memory Infrastructure. The components are:

Why ManasDB?

Supported Databases

Example Interaction

Here is how it works end-to-end in Claude Desktop:

User: Remember my name is Akshay.

Claude → memorize called

{
  "text": "User name is Akshay"
}

✅ Successfully memorized the context across all healthy database providers.

Later in a new conversation...

User: What is my name?

Claude → recall called

{
  "query": "user name"
}

Claude: Your name is Akshay.

Setup & Configuration

For deeper information on how ManasDB's polyglot memory, chunking, and retrieval algorithms work, see the primary SDK: @manasdb/core.

Interactive Setup (Recommended)

npx @manasdb/mcp-server setup

The wizard will ask you for:

1. Project Name

2. MongoDB URI

3. PostgreSQL URI

4. Embedding Model Source (transformers, ollama, gemini, openai)

5. Model Name (e.g. nomic-embed-text:latest for Ollama)

6. Enable Telemetry

It then outputs a ready-to-use claude_desktop_config.json snippet.

Manual Configuration

Pass the full config to as a --manas-config argument or set MANAS_DB_CONFIG as an environment variable. The config supports all @manasdb/core options:

{
  "databases": [
    {
      "type": "mongodb",
      "uri": "mongodb://localhost:27017",
      "dbName": "my_app"
    },
    { "type": "postgres", "uri": "postgresql://localhost:5432/postgres" }
  ],
  "projectName": "knowledge_base",
  "modelConfig": { "source": "ollama", "model": "nomic-embed-text:latest" },
  "telemetry": true,
  "debug": false
}

Integrations

Claude Desktop

{
  "mcpServers": {
    "manasdb": {
      "command": "npx",
      "args": [
        "-y",
        "@manasdb/mcp-server",
        "--manas-config={\"databases\":[{\"type\":\"mongodb\",\"uri\":\"mongodb://...\"}],\"modelConfig\":{\"source\":\"transformers\"}}"
      ]
    }
  }
}

Cursor

1. Open Settings → Features → MCP Servers

2. Click + Add new MCP Server

3. Type: command

4. Command: npx -y @manasdb/mcp-server --manas-config="{...}"

Available Tools

Tip: Use recall first to find the contentId of the memory you want to delete, then pass it to forget.

License

See LICENSE.