Metadata-Version: 2.4
Name: better-mem0-mcp
Version: 1.2.1b2
Summary: [DEPRECATED - use EchoVault] MCP Server for AI memory with PostgreSQL
Project-URL: Homepage, https://github.com/n24q02m/better-mem0-mcp
Project-URL: Repository, https://github.com/n24q02m/better-mem0-mcp.git
Project-URL: Issues, https://github.com/n24q02m/better-mem0-mcp/issues
Author-email: n24q02m <quangminh2422004@gmail.com>
License: MIT
License-File: LICENSE
Keywords: ai-agent,deprecated,llm,mcp,mem0,memory,pgvector
Classifier: Development Status :: 7 - Inactive
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: ==3.13.*
Requires-Dist: google-genai
Requires-Dist: litellm
Requires-Dist: loguru
Requires-Dist: mcp[cli]
Requires-Dist: mem0ai
Requires-Dist: psycopg[binary,pool]
Requires-Dist: pydantic-settings
Description-Content-Type: text/markdown

# better-mem0-mcp

> [!CAUTION]
> **DỰ ÁN ĐÃ NGỪNG PHÁT TRIỂN** — Xem phần [Chuyển sang EchoVault](#chuyển-sang-echovault) bên dưới.

**Self-hosted MCP Server for AI memory with PostgreSQL (pgvector).**

[![PyPI](https://img.shields.io/pypi/v/better-mem0-mcp)](https://pypi.org/project/better-mem0-mcp/)
[![Docker](https://img.shields.io/docker/v/n24q02m/better-mem0-mcp?label=docker)](https://hub.docker.com/r/n24q02m/better-mem0-mcp)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)

---

## Thông báo ngừng phát triển

Dự án `better-mem0-mcp` đã **ngừng phát triển** kể từ tháng 02/2026.

Giải pháp thay thế đã được tích hợp trực tiếp vào [EchoVault](https://github.com/n24q02m/EchoVault) — black box cho toàn bộ lịch sử hội thoại AI của bạn. EchoVault không chỉ trích xuất và lưu trữ raw chat data mà còn:

- **Parse và embed nội dung** từ 12+ AI coding tools (VS Code Copilot, Cursor, Cline, Claude Code, Gemini CLI, Aider...)
- **Tìm kiếm ngữ nghĩa + từ khóa** — hybrid search kết hợp vector similarity (cosine) và FTS5 keyword search qua RRF fusion
- **Giao diện desktop app** (Tauri) để quản lý, tìm kiếm trực quan với system tray, auto-sync, auto-update
- **MCP Server tích hợp** (`echovault-cli mcp`) — AI agents truy vấn vault qua tool `vault` với các action: `list`, `search`, `read`, `semantic_search`

So với `better-mem0-mcp`, EchoVault có kiến trúc tốt hơn:
- **Không phụ thuộc dịch vụ bên ngoài** — không cần Mem0, LiteLLM, hay PostgreSQL cloud (Neon/Supabase). Mọi thứ chạy local với SQLite + Ollama
- **Nguồn dữ liệu phong phú** — tự động trích xuất từ 12+ IDE/CLI tools thay vì phải thêm thủ công
- **Trải nghiệm thống nhất** — cùng một vault, dùng được trên cả desktop app, CLI, và MCP server

### Chuyển sang EchoVault

1. **Cài đặt**: Tải từ [GitHub Releases](https://github.com/n24q02m/EchoVault/releases) hoặc chạy script:
   ```powershell
   # Windows - Desktop App + CLI
   irm https://raw.githubusercontent.com/n24q02m/EchoVault/main/install.ps1 | iex

   # Chỉ CLI/MCP (headless)
   irm https://raw.githubusercontent.com/n24q02m/EchoVault/main/install-cli.ps1 | iex
   ```
2. **Trích xuất và index**: `echovault-cli extract && echovault-cli parse && echovault-cli embed`
3. **Cập nhật MCP config**:
   ```json
   {
     "mcpServers": {
       "echovault": {
         "command": "echovault-cli",
         "args": ["mcp"]
       }
     }
   }
   ```

---

## Tài liệu cũ

> [!NOTE]
> Nội dung bên dưới được giữ lại để tham khảo. Phiên bản cuối cùng trên PyPI/Docker vẫn hoạt động nhưng sẽ **không nhận bản cập nhật mới**.

## Features

- **Self-hosted PostgreSQL** - Your data stays with you (Neon/Supabase free tier supported)
- **Graph Memory** - SQL-based relationship tracking alongside vector memory
- **Multi-provider LLM** - Gemini, OpenAI, Anthropic, Groq, DeepSeek, Mistral
- **Fallback chains** - Multi-key per provider + multi-model fallback
- **Zero manual setup** - Just `DATABASE_URL` + `API_KEYS`

---

<details>
<summary><strong>Quick Start (Legacy)</strong></summary>

### 1. Get Prerequisites

- **Database**: [Neon](https://neon.tech) or [Supabase](https://supabase.com) (free tier works)
- **API Key**: Any supported provider ([Google AI Studio](https://aistudio.google.com/apikey) is free)

### 2. Add to mcp.json

#### uvx (Recommended)

```json
{
  "mcpServers": {
    "better-mem0": {
      "command": "uvx",
      "args": ["better-mem0-mcp@latest"],
      "env": {
        "DATABASE_URL": "postgresql://user:pass@xxx.neon.tech/neondb?sslmode=require",
        "API_KEYS": "GOOGLE_API_KEY:AIza..."
      }
    }
  }
}
```

#### Docker

```json
{
  "mcpServers": {
    "better-mem0": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "DATABASE_URL", "-e", "API_KEYS", "n24q02m/better-mem0-mcp:latest"],
      "env": {
        "DATABASE_URL": "postgresql://...",
        "API_KEYS": "GOOGLE_API_KEY:AIza..."
      }
    }
  }
}
```

### 3. Done!

Ask your AI: "Remember that I prefer dark mode and use FastAPI"

</details>

<details>
<summary><strong>Configuration (Legacy)</strong></summary>

| Variable | Required | Description |
|----------|----------|-------------|
| `DATABASE_URL` | Yes | PostgreSQL with pgvector extension |
| `API_KEYS` | Yes | `ENV_VAR:key` pairs, comma-separated |
| `LLM_MODELS` | No | Model fallback chain |
| `EMBEDDER_MODELS` | No | Embedding model chain |

### Supported LiteLLM Providers

Use environment variable names from [LiteLLM docs](https://docs.litellm.ai/):
`GOOGLE_API_KEY`, `OPENAI_API_KEY`, `ANTHROPIC_API_KEY`, `GROQ_API_KEY`, etc.

**Single provider:**
```bash
API_KEYS=GOOGLE_API_KEY:AIza...
```

**Multi-key with fallback:**
```bash
API_KEYS=GOOGLE_API_KEY:AIza-1,GOOGLE_API_KEY:AIza-2,OPENAI_API_KEY:sk-xxx
LLM_MODELS=gemini/gemini-3-flash-preview,openai/gpt-4o-mini
EMBEDDER_MODELS=gemini/gemini-embedding-001,openai/text-embedding-3-small
```

### Defaults

| Setting | Default |
|---------|---------|
| `LLM_MODELS` | `gemini/gemini-3-flash-preview` |
| `EMBEDDER_MODELS` | `gemini/gemini-embedding-001` |

</details>

<details>
<summary><strong>Tools (Legacy)</strong></summary>

| Tool | Description |
|------|-------------|
| `memory` | Memory operations: `add`, `search`, `list`, `delete` |
| `help` | Get full documentation for tools |

### Usage Examples

```json
{"action": "add", "content": "I prefer TypeScript over JavaScript"}
{"action": "search", "query": "programming preferences"}
{"action": "list"}
{"action": "delete", "memory_id": "abc123"}
```

</details>

<details>
<summary><strong>Build from Source (Legacy)</strong></summary>

```bash
git clone https://github.com/n24q02m/better-mem0-mcp
cd better-mem0-mcp

# Setup (requires mise: https://mise.jdx.dev/)
mise run setup

# Run
uv run better-mem0-mcp
```

**Requirements:** Python 3.13+

</details>

---

## License

MIT - See [LICENSE](LICENSE)
