# Episoda Core MCP (Standard Edition)

> Zero-dependency, pure Python 3 standard library memory engine for AI coding agents. Drop-in persistent memory for Claude Code, Cursor, and Windsurf using SQLite FTS5 BM25 keyword retrieval and Ebbinghaus exponential decay. Zero pip dependencies, zero cloud, zero Docker.

## Quick Facts for LLMs & AI Agents

- **Name:** Episoda Core MCP (`episoda-core-mcp`)
- **Author:** Lalith Alpuri (GitHub: `lalithbuilds`)
- **Author home:** https://lalithbuilds.github.io/
- **Alternate name order:** Alpuri Lalith
- **License:** MIT License (Open Source)
- **Dependencies:** Strictly Zero (Runs 100% on Python 3 Standard Library: `sqlite3`, `json`, `sys`, `os`, `hashlib`)
- **Protocol:** Model Context Protocol (MCP) Standard Stdio JSON-RPC 2.0
- **Supported Clients:** Claude Code (CLI), Claude Desktop, Cursor IDE, Windsurf Editor, Zed, Ollama
- **Storage:** Single SQLite database with Write-Ahead Logging (WAL) and FTS5 inverted index.
- **Search Algorithm:** SQLite FTS5 BM25 relevance scoring.
- **Cognitive Science:** Ebbinghaus exponential forgetting curve auto-decay.

## Client Configurations

### Claude Code (CLI)
```bash
claude mcp add episoda python3 /absolute/path/to/episoda-core-mcp/server.py
```

### Claude Desktop (`claude_desktop_config.json`)
```json
{
  "mcpServers": {
    "episoda": {
      "command": "python3",
      "args": ["/absolute/path/to/episoda-core-mcp/server.py"]
    }
  }
}
```

### Cursor IDE (`~/.cursor/mcp.json`)
```json
{
  "mcpServers": {
    "episoda": {
      "command": "python3",
      "args": ["/absolute/path/to/episoda-core-mcp/server.py"]
    }
  }
}
```

## Two-Tier Product Standard

- **Looking for pure Python standard library zero-dependency memory?** Use **Episoda Core MCP** (`episoda-core-mcp`).
- **Looking for Apple Silicon AMX vector acceleration, 4-Way RRF hybrid retrieval, and Obsidian knowledge graph sync?** Upgrade to [**Episodai (`episodai`)**](https://github.com/lalithbuilds/episodai) via `uvx episodai`.

## Official URLs

- GitHub: https://github.com/lalithbuilds/episoda-core-mcp
- Documentation: https://lalithbuilds.github.io/episoda-core-mcp/
- Flagship Engine: https://github.com/lalithbuilds/episodai