better-mem0-mcp 1.1.5__py3-none-any.whl → 1.2.0__py3-none-any.whl

better_mem0_mcp/config.py

@@ -33,43 +33,36 @@ class Settings(BaseSettings):
     embedder_models: str = "gemini/gemini-embedding-001"
 
     def setup_api_keys(self) -> dict[str, list[str]]:
-        """
-        Parse API_KEYS and set environment variables for LiteLLM.
+        """Parse API_KEYS (format: ENV_VAR:key,...) and set env vars.
+
+        Example:
+            API_KEYS="GOOGLE_API_KEY:abc,GOOGLE_API_KEY:def,OPENAI_API_KEY:xyz"
 
         Returns:
-            Dict mapping provider to list of API keys.
+            Dict mapping env var name to list of API keys.
         """
-        env_map = {
-            "gemini": "GOOGLE_API_KEY",
-            "openai": "OPENAI_API_KEY",
-            "anthropic": "ANTHROPIC_API_KEY",
-            "groq": "GROQ_API_KEY",
-            "deepseek": "DEEPSEEK_API_KEY",
-            "mistral": "MISTRAL_API_KEY",
-        }
-
-        keys_by_provider: dict[str, list[str]] = {}
+        keys_by_env: dict[str, list[str]] = {}
 
         for pair in self.api_keys.split(","):
             pair = pair.strip()
             if ":" not in pair:
                 continue
 
-            provider, key = pair.split(":", 1)
-            provider = provider.strip().lower()
+            env_var, key = pair.split(":", 1)
+            env_var = env_var.strip()
             key = key.strip()
 
             if not key:
                 continue
 
-            keys_by_provider.setdefault(provider, []).append(key)
+            keys_by_env.setdefault(env_var, []).append(key)
 
-        # Set first key of each provider as env var (LiteLLM reads from env)
-        for provider, keys in keys_by_provider.items():
-            if provider in env_map and keys:
-                os.environ[env_map[provider]] = keys[0]
+        # Set first key of each env var (LiteLLM reads from env)
+        for env_var, keys in keys_by_env.items():
+            if keys:
+                os.environ[env_var] = keys[0]
 
-        return keys_by_provider
+        return keys_by_env
 
     def parse_database_url(self) -> dict:
         """Parse DATABASE_URL into connection parameters."""

better_mem0_mcp-1.2.0.dist-info/METADATA

@@ -0,0 +1,173 @@
+Metadata-Version: 2.4
+Name: better-mem0-mcp
+Version: 1.2.0
+Summary: Zero-setup MCP Server for AI memory - works with Neon/Supabase
+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,llm,mcp,mem0,memory,pgvector
+Classifier: Development Status :: 4 - Beta
+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
+
+**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)
+
+## 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`
+
+---
+
+## Quick Start
+
+### 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"
+
+---
+
+## Configuration
+
+| 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` |
+
+---
+
+## Tools
+
+| 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"}
+```
+
+---
+
+## Build from Source
+
+```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+
+
+---
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md)
+
+## License
+
+MIT - See [LICENSE](LICENSE)

{better_mem0_mcp-1.1.5.dist-info → better_mem0_mcp-1.2.0.dist-info}/RECORD

@@ -1,12 +1,12 @@
 better_mem0_mcp/__init__.py,sha256=fcqgbz2HvMCPidqqoPvtRky5pGIHP2w9oVim7UQkuBc,106
 better_mem0_mcp/__main__.py,sha256=IeeRidmZF4oBaamjQM6FUbhXpsSdE4sQF_6y_D2GEE4,116
-better_mem0_mcp/config.py,sha256=vgKLIw3jHyeBLTzzBnuHV5x6Nra0Rbav1IJRL8rLCuk,5576
+better_mem0_mcp/config.py,sha256=cqLGzxYno7SgRMn7Y8GOBR0P4CrBuFjsmFpK6eGZhs0,5312
 better_mem0_mcp/graph.py,sha256=rE9z6XECiAktEqDNgmwqCpFpvKSn3azO9H4sRBhj8UU,6195
 better_mem0_mcp/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 better_mem0_mcp/server.py,sha256=QYLP46pz0U9gkxQKB_g8FMga77ywElMMjSCU-hGZQ-M,5499
 better_mem0_mcp/docs/memory.md,sha256=198dDuAGccG5Ca7rhEXIU03ZhxNKK44B_Brl2glurGc,1608
-better_mem0_mcp-1.1.5.dist-info/METADATA,sha256=1ODBBzEOthes61CKEl7vFbbPs3e5ND_GzNFQemFQI-M,3888
-better_mem0_mcp-1.1.5.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-better_mem0_mcp-1.1.5.dist-info/entry_points.txt,sha256=2b7E3D6yo94mQXP2Ms0bhUlWkK9f664f0GrstImOq30,57
-better_mem0_mcp-1.1.5.dist-info/licenses/LICENSE,sha256=d7xQ6sRyeGus6gnvwgqiQtSY7XdFw0Jd0w5-Co_xHnk,1064
-better_mem0_mcp-1.1.5.dist-info/RECORD,,
+better_mem0_mcp-1.2.0.dist-info/METADATA,sha256=141SpGEaPKcg0-koPix7VrQGjXg0VW5fIH2ba0HC7qY,4627
+better_mem0_mcp-1.2.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+better_mem0_mcp-1.2.0.dist-info/entry_points.txt,sha256=2b7E3D6yo94mQXP2Ms0bhUlWkK9f664f0GrstImOq30,57
+better_mem0_mcp-1.2.0.dist-info/licenses/LICENSE,sha256=d7xQ6sRyeGus6gnvwgqiQtSY7XdFw0Jd0w5-Co_xHnk,1064
+better_mem0_mcp-1.2.0.dist-info/RECORD,,

better_mem0_mcp-1.1.5.dist-info/METADATA

@@ -1,149 +0,0 @@
-Metadata-Version: 2.4
-Name: better-mem0-mcp
-Version: 1.1.5
-Summary: Zero-setup MCP Server for AI memory - works with Neon/Supabase
-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,llm,mcp,mem0,memory,pgvector
-Classifier: Development Status :: 4 - Beta
-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>=1.0.0
-Requires-Dist: litellm>=1.0.0
-Requires-Dist: loguru>=0.7.0
-Requires-Dist: mcp[cli]>=1.0.0
-Requires-Dist: mem0ai>=0.1.0
-Requires-Dist: psycopg[binary,pool]>=3.1.0
-Requires-Dist: pydantic-settings>=2.0.0
-Description-Content-Type: text/markdown
-
-# better-mem0-mcp
-
-**Zero-setup** MCP Server for AI memory. Works with Neon/Supabase free tier.
-
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-
-## Quick Start
-
-### 1. Get Prerequisites
-
-- **Database**: [Neon](https://neon.tech) or [Supabase](https://supabase.com) (free tier)
-- **API Key**: [Google AI Studio](https://aistudio.google.com/apikey) (free tier)
-
-### 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": "gemini: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": "gemini:AIza..."
-      }
-    }
-  }
-}
-```
-
-### 3. Done!
-
-Ask Claude: "Remember that I prefer dark mode and use FastAPI"
-
----
-
-## Configuration
-
-| Variable | Required | Description |
-|----------|----------|-------------|
-| `DATABASE_URL` | Yes | PostgreSQL connection string |
-| `API_KEYS` | Yes | `provider:key,...` (multi-key per provider OK) |
-| `LLM_MODELS` | No | `provider/model,...` (fallback chain) |
-| `EMBEDDER_MODELS` | No | `provider/model,...` (fallback chain) |
-
-### Examples
-
-**Minimal (Gemini only):**
-```
-API_KEYS=gemini:AIza...
-```
-
-**Multi-key with fallback:**
-```
-API_KEYS=gemini:AIza-1,gemini:AIza-2,openai:sk-xxx
-LLM_MODELS=gemini/gemini-2.5-flash,openai/gpt-4o-mini
-EMBEDDER_MODELS=gemini/gemini-embedding-001,openai/text-embedding-3-small
-```
-
-### Defaults
-
-| Setting | Default |
-|---------|---------|
-| `LLM_MODELS` | `gemini/gemini-2.5-flash` |
-| `EMBEDDER_MODELS` | `gemini/gemini-embedding-001` |
-
----
-
-## Tools
-
-| Tool | Description |
-|------|-------------|
-| `memory` | `action`: add, search, list, delete |
-| `help` | Detailed documentation |
-
-### Usage
-
-```json
-{"action": "add", "content": "I prefer TypeScript over JavaScript"}
-{"action": "search", "query": "preferences"}
-{"action": "list"}
-{"action": "delete", "memory_id": "abc123"}
-```
-
----
-
-## Why better-mem0-mcp?
-
-| Feature | Official mem0-mcp | better-mem0-mcp |
-|---------|-------------------|-----------------|
-| Storage | Mem0 Cloud | **Self-hosted PostgreSQL** |
-| Graph Memory | No | **Yes (SQL-based)** |
-| LLM Provider | OpenAI only | **Any (Gemini/OpenAI/Ollama/...)** |
-| Fallback | No | **Yes (multi-key + multi-model)** |
-| Setup | API Key | **DATABASE_URL + API_KEYS** |
-
----
-
-## License
-
-MIT