---
license: mit
title: SUMIT SERVER MCP
sdk: docker
emoji: "\U0001F680"
colorFrom: yellow
colorTo: green
short_description: Federated memory MCP server with semantic search
---

# sumit-mcp-server

A federated memory MCP server with semantic search, immutable versioning, multi-user auth, and full audit trails. Built on Qdrant vector database and FastMCP.

## Available Tools

### Write

| Tool | Description |
|------|-------------|
| `put_task_to_db` | Add a memory with optional category, tags, project. Dedup via semantic similarity (0.85 threshold). |

### Read

| Tool | Description |
|------|-------------|
| `get_task_from_db` | Get all memories for a specific date |
| `search_memory_by_keyword` | Keyword search in task descriptions |
| `get_memories_by_category` | Filter by category (work, research, personal, learning) |
| `get_memories_by_project` | Filter by project name |
| `get_memories_by_tags` | Filter by any matching tag |
| `get_recent_memories` | Get memories from the last N days |

### Lifecycle

| Tool | Description |
|------|-------------|
| `get_memory_by_id` | Get a specific memory by ID |
| `update_memory` | Create a new version with updated fields (original preserved) |
| `archive_memory` | Soft-archive a memory (excluded from default queries) |
| `unarchive_memory` | Restore an archived memory to active |

### Trail & Stats

| Tool | Description |
|------|-------------|
| `get_memory_trail` | Full transaction trail for a memory |
| `get_memory_versions` | All versions of a memory, oldest to newest |
| `get_access_stats` | Access statistics (per-memory or top-accessed) |

### Search & Admin

| Tool | Description |
|------|-------------|
| `semantic_search` | Vector similarity search with configurable threshold |
| `backfill_embeddings` | (Admin) Re-embed all memories with zero vectors |

## Quick Start

```bash
git clone https://github.com/rockerritesh/sumit-mcp-server.git
cd sumit-mcp-server
uv sync
```

Create a `.env` file:

```bash
PORT=7860
QDRANT_URL=your_qdrant_cloud_url
QDRANT_API_KEY=your_qdrant_api_key
```

Run:

```bash
sumit-mcp-server
```

Server starts at `http://localhost:7860` with MCP endpoint at `/api/mcp/`.

## Architecture

- **Storage:** Qdrant Cloud vector database (3 collections: memories, trails, users)
- **Embeddings:** FastEmbed with all-MiniLM-L6-v2 (384-dim, ONNX Runtime, CPU)
- **Auth:** Token-based multi-user with admin/user roles and data isolation
- **Versioning:** Immutable — updates create new versions, originals preserved
- **Audit:** Full transaction trail for every memory lifecycle event

## Docker

```bash
docker build -t sumit-mcp-server .
docker run -p 7860:7860 \
  -e QDRANT_URL=your_url \
  -e QDRANT_API_KEY=your_key \
  sumit-mcp-server
```

## License

MIT