mem0-open-mcp 0.1.0__tar.gz

mem0_open_mcp-0.1.0/.env.example

@@ -0,0 +1,19 @@
+# mem0-server environment variables
+
+# OpenAI (default provider)
+OPENAI_API_KEY=your_openai_api_key_here
+
+# Anthropic (optional)
+# ANTHROPIC_API_KEY=your_anthropic_api_key_here
+
+# Ollama (for local LLM)
+# No API key needed, just set base_url in config
+
+# Vector Store (cloud options)
+# QDRANT_API_KEY=your_qdrant_cloud_api_key
+# PINECONE_API_KEY=your_pinecone_api_key
+
+# Server settings (can also be set in config file)
+# MEM0_SERVER_HOST=0.0.0.0
+# MEM0_SERVER_PORT=8765
+# MEM0_SERVER_USER_ID=default

mem0_open_mcp-0.1.0/.gitignore

@@ -0,0 +1,62 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+env/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# Testing
+.tox/
+.nox/
+.coverage
+.coverage.*
+htmlcov/
+.pytest_cache/
+.mypy_cache/
+
+# Ruff
+.ruff_cache/
+
+# Environment
+.env
+.env.local
+
+# Config files with secrets
+mem0-server.yaml
+!mem0-server.example.yaml
+
+# Docker
+.docker/
+
+# OS
+.DS_Store
+Thumbs.db
+mem0-open-mcp.yaml

mem0_open_mcp-0.1.0/Dockerfile

@@ -0,0 +1,29 @@
+FROM python:3.11-slim
+
+WORKDIR /app
+
+# Install system dependencies
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    curl \
+    && rm -rf /var/lib/apt/lists/*
+
+# Copy package files
+COPY pyproject.toml README.md ./
+COPY src/ ./src/
+
+# Install package
+RUN pip install --no-cache-dir -e .
+
+# Copy example config
+COPY mem0-server.example.yaml /app/mem0-server.yaml
+
+# Expose port
+EXPOSE 8765
+
+# Health check
+HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \
+    CMD curl -f http://localhost:8765/health || exit 1
+
+# Run server
+ENTRYPOINT ["mem0-server"]
+CMD ["serve", "--config", "/app/mem0-server.yaml"]

mem0_open_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,187 @@
+Metadata-Version: 2.4
+Name: mem0-open-mcp
+Version: 0.1.0
+Summary: Open-source MCP server for mem0 - local LLMs, self-hosted, Docker-free
+Author: Alex
+License-Expression: Apache-2.0
+Keywords: ai,llm,local,mcp,mem0,memory,ollama,server
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.10
+Requires-Dist: fastapi>=0.115.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: mem0ai>=1.0.0
+Requires-Dist: pydantic-settings>=2.0.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: pyyaml>=6.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: typer[all]>=0.12.0
+Requires-Dist: uvicorn[standard]>=0.32.0
+Provides-Extra: chroma
+Requires-Dist: chromadb>=0.5.0; extra == 'chroma'
+Provides-Extra: dev
+Requires-Dist: mypy>=1.13.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.24.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.8.0; extra == 'dev'
+Provides-Extra: ollama
+Requires-Dist: ollama>=0.4.0; extra == 'ollama'
+Provides-Extra: pinecone
+Requires-Dist: pinecone>=5.0.0; extra == 'pinecone'
+Provides-Extra: qdrant
+Requires-Dist: qdrant-client>=1.12.0; extra == 'qdrant'
+Description-Content-Type: text/markdown
+
+# mem0-open-mcp
+
+Open-source MCP server for [mem0](https://mem0.ai) — **local LLMs, self-hosted, Docker-free**.
+
+Created because the official `mem0-mcp` configuration wasn't working properly for my setup.
+
+## Features
+
+- **Local LLMs**: Ollama (recommended), LMStudio*, or any OpenAI-compatible API
+- **Self-hosted**: Your data stays on your infrastructure
+- **Docker-free**: Simple `pip install` + CLI
+- **Flexible**: YAML config with environment variable support
+- **Multiple Vector Stores**: Qdrant, Chroma, Pinecone, and more
+
+> *LMStudio requires JSON mode compatible models
+
+## Quick Start
+
+### Installation
+
+Install from source:
+
+```bash
+git clone https://github.com/yourname/mem0-open-mcp.git
+cd mem0-open-mcp
+pip install -e .
+```
+
+### Usage
+
+```bash
+# Create default config
+mem0-open-mcp init
+
+# Interactive configuration wizard
+mem0-open-mcp configure
+
+# Start the server
+mem0-open-mcp serve
+
+# With options
+mem0-open-mcp serve --port 8765 --user-id alice
+```
+
+## Configuration
+
+Create `mem0-open-mcp.yaml`:
+
+```yaml
+server:
+  host: "0.0.0.0"
+  port: 8765
+  user_id: "default"
+
+llm:
+  provider: "ollama"
+  config:
+    model: "llama3.2"
+    base_url: "http://localhost:11434"
+
+embedder:
+  provider: "ollama"
+  config:
+    model: "nomic-embed-text"
+    base_url: "http://localhost:11434"
+    embedding_dims: 768
+
+vector_store:
+  provider: "qdrant"
+  config:
+    collection_name: "mem0_memories"
+    host: "localhost"
+    port: 6333
+    embedding_model_dims: 768
+```
+
+### With LMStudio
+
+> **⚠️ Note**: LMStudio requires a model that supports `response_format: json_object`. 
+> mem0 uses structured JSON output for memory extraction. If you get `response_format` errors,
+> use Ollama instead or select a model with JSON mode support in LMStudio.
+
+```yaml
+llm:
+  provider: "openai"
+  config:
+    model: "your-model-name"
+    base_url: "http://localhost:1234/v1"
+
+embedder:
+  provider: "openai"
+  config:
+    model: "your-embedding-model"
+    base_url: "http://localhost:1234/v1"
+```
+
+## MCP Integration
+
+Connect your MCP client to:
+
+```
+http://localhost:8765/mcp/<client-name>/sse/<user-id>
+```
+
+### Claude Desktop
+
+```json
+{
+  "mcpServers": {
+    "mem0": {
+      "url": "http://localhost:8765/mcp/claude/sse/default"
+    }
+  }
+}
+```
+
+## Available MCP Tools
+
+| Tool | Description |
+|------|-------------|
+| `add_memories` | Store new memories from text |
+| `search_memory` | Search memories by query |
+| `list_memories` | List all user memories |
+| `get_memory` | Get a specific memory by ID |
+| `delete_memories` | Delete memories by IDs |
+| `delete_all_memories` | Delete all user memories |
+
+## API Endpoints
+
+| Endpoint | Method | Description |
+|----------|--------|-------------|
+| `/health` | GET | Health check |
+| `/api/v1/status` | GET | Server status |
+| `/api/v1/config` | GET/PUT | Configuration |
+| `/api/v1/memories` | GET/POST/DELETE | Memory operations |
+| `/api/v1/memories/search` | POST | Search memories |
+
+## Requirements
+
+- Python 3.10+
+- Vector store (Qdrant recommended)
+- LLM server (Ollama, LMStudio, etc.)
+
+## License
+
+Apache 2.0

mem0_open_mcp-0.1.0/README.md

@@ -0,0 +1,146 @@
+# mem0-open-mcp
+
+Open-source MCP server for [mem0](https://mem0.ai) — **local LLMs, self-hosted, Docker-free**.
+
+Created because the official `mem0-mcp` configuration wasn't working properly for my setup.
+
+## Features
+
+- **Local LLMs**: Ollama (recommended), LMStudio*, or any OpenAI-compatible API
+- **Self-hosted**: Your data stays on your infrastructure
+- **Docker-free**: Simple `pip install` + CLI
+- **Flexible**: YAML config with environment variable support
+- **Multiple Vector Stores**: Qdrant, Chroma, Pinecone, and more
+
+> *LMStudio requires JSON mode compatible models
+
+## Quick Start
+
+### Installation
+
+Install from source:
+
+```bash
+git clone https://github.com/yourname/mem0-open-mcp.git
+cd mem0-open-mcp
+pip install -e .
+```
+
+### Usage
+
+```bash
+# Create default config
+mem0-open-mcp init
+
+# Interactive configuration wizard
+mem0-open-mcp configure
+
+# Start the server
+mem0-open-mcp serve
+
+# With options
+mem0-open-mcp serve --port 8765 --user-id alice
+```
+
+## Configuration
+
+Create `mem0-open-mcp.yaml`:
+
+```yaml
+server:
+  host: "0.0.0.0"
+  port: 8765
+  user_id: "default"
+
+llm:
+  provider: "ollama"
+  config:
+    model: "llama3.2"
+    base_url: "http://localhost:11434"
+
+embedder:
+  provider: "ollama"
+  config:
+    model: "nomic-embed-text"
+    base_url: "http://localhost:11434"
+    embedding_dims: 768
+
+vector_store:
+  provider: "qdrant"
+  config:
+    collection_name: "mem0_memories"
+    host: "localhost"
+    port: 6333
+    embedding_model_dims: 768
+```
+
+### With LMStudio
+
+> **⚠️ Note**: LMStudio requires a model that supports `response_format: json_object`. 
+> mem0 uses structured JSON output for memory extraction. If you get `response_format` errors,
+> use Ollama instead or select a model with JSON mode support in LMStudio.
+
+```yaml
+llm:
+  provider: "openai"
+  config:
+    model: "your-model-name"
+    base_url: "http://localhost:1234/v1"
+
+embedder:
+  provider: "openai"
+  config:
+    model: "your-embedding-model"
+    base_url: "http://localhost:1234/v1"
+```
+
+## MCP Integration
+
+Connect your MCP client to:
+
+```
+http://localhost:8765/mcp/<client-name>/sse/<user-id>
+```
+
+### Claude Desktop
+
+```json
+{
+  "mcpServers": {
+    "mem0": {
+      "url": "http://localhost:8765/mcp/claude/sse/default"
+    }
+  }
+}
+```
+
+## Available MCP Tools
+
+| Tool | Description |
+|------|-------------|
+| `add_memories` | Store new memories from text |
+| `search_memory` | Search memories by query |
+| `list_memories` | List all user memories |
+| `get_memory` | Get a specific memory by ID |
+| `delete_memories` | Delete memories by IDs |
+| `delete_all_memories` | Delete all user memories |
+
+## API Endpoints
+
+| Endpoint | Method | Description |
+|----------|--------|-------------|
+| `/health` | GET | Health check |
+| `/api/v1/status` | GET | Server status |
+| `/api/v1/config` | GET/PUT | Configuration |
+| `/api/v1/memories` | GET/POST/DELETE | Memory operations |
+| `/api/v1/memories/search` | POST | Search memories |
+
+## Requirements
+
+- Python 3.10+
+- Vector store (Qdrant recommended)
+- LLM server (Ollama, LMStudio, etc.)
+
+## License
+
+Apache 2.0

mem0_open_mcp-0.1.0/docker-compose.yaml

@@ -0,0 +1,49 @@
+version: "3.8"
+
+services:
+  # Vector database
+  qdrant:
+    image: qdrant/qdrant:latest
+    ports:
+      - "6333:6333"
+      - "6334:6334"
+    volumes:
+      - qdrant_data:/qdrant/storage
+    restart: unless-stopped
+
+  # mem0-server
+  mem0-server:
+    build:
+      context: .
+      dockerfile: Dockerfile
+    ports:
+      - "8765:8765"
+    environment:
+      - OPENAI_API_KEY=${OPENAI_API_KEY}
+      # For Ollama, uncomment the following:
+      # - OLLAMA_HOST=http://host.docker.internal:11434
+    volumes:
+      - ./mem0-server.yaml:/app/mem0-server.yaml:ro
+    depends_on:
+      - qdrant
+    restart: unless-stopped
+    healthcheck:
+      test: ["CMD", "curl", "-f", "http://localhost:8765/health"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 10s
+
+  # Optional: Ollama for local LLM
+  # Uncomment to use Ollama
+  # ollama:
+  #   image: ollama/ollama:latest
+  #   ports:
+  #     - "11434:11434"
+  #   volumes:
+  #     - ollama_data:/root/.ollama
+  #   restart: unless-stopped
+
+volumes:
+  qdrant_data:
+  # ollama_data:

mem0_open_mcp-0.1.0/examples/ollama-config.yaml

@@ -0,0 +1,32 @@
+# Ollama configuration example for mem0-server
+# Use this for fully local LLM and embedding
+
+server:
+  host: "0.0.0.0"
+  port: 8765
+  user_id: "default"
+  log_level: "info"
+
+llm:
+  provider: "ollama"
+  config:
+    model: "llama3.2"  # or mistral, gemma2, etc.
+    temperature: 0.1
+    max_tokens: 2000
+    base_url: "http://localhost:11434"
+
+embedder:
+  provider: "ollama"
+  config:
+    model: "nomic-embed-text"  # or mxbai-embed-large
+    base_url: "http://localhost:11434"
+
+vector_store:
+  provider: "qdrant"
+  config:
+    collection_name: "mem0_memories"
+    host: "localhost"
+    port: 6333
+
+openmemory:
+  custom_instructions: null

mem0_open_mcp-0.1.0/mem0-open-mcp.example.yaml

@@ -0,0 +1,54 @@
+# Default configuration file for mem0-server
+# See https://docs.mem0.ai for provider options
+
+server:
+  host: "0.0.0.0"
+  port: 8765
+  user_id: "default"
+  log_level: "info"
+  reload: false
+
+# LLM Configuration
+# Providers: openai, anthropic, azure_openai, ollama, together, groq, 
+#            litellm, mistralai, google_ai, aws_bedrock, gemini, deepseek, xai, lmstudio
+llm:
+  provider: "openai"
+  config:
+    model: "gpt-4o-mini"
+    temperature: 0.1
+    max_tokens: 2000
+    # Use env:VAR_NAME to read from environment variable
+    api_key: "env:OPENAI_API_KEY"
+    # For Ollama, set base_url instead:
+    # base_url: "http://localhost:11434"
+
+# Embedder Configuration
+# Providers: openai, azure_openai, ollama, huggingface, vertexai, gemini, 
+#            lmstudio, together, aws_bedrock
+embedder:
+  provider: "openai"
+  config:
+    model: "text-embedding-3-small"
+    api_key: "env:OPENAI_API_KEY"
+    # For Ollama:
+    # base_url: "http://localhost:11434"
+
+# Vector Store Configuration
+# Providers: qdrant, chroma, pinecone, milvus, weaviate, pgvector, 
+#            faiss, redis, azure_ai_search, vertex_ai_vector_search, mongodb_atlas, memory
+vector_store:
+  provider: "qdrant"
+  config:
+    collection_name: "mem0_memories"
+    host: "localhost"
+    port: 6333
+    # For cloud services:
+    # api_key: "env:QDRANT_API_KEY"
+    # url: "https://your-cluster.qdrant.io"
+
+# OpenMemory Settings
+openmemory:
+  # Custom instructions for memory extraction (optional)
+  custom_instructions: null
+  # Custom category definitions (optional)
+  custom_categories: null

mem0_open_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,73 @@
+[project]
+name = "mem0-open-mcp"
+version = "0.1.0"
+description = "Open-source MCP server for mem0 - local LLMs, self-hosted, Docker-free"
+readme = "README.md"
+license = "Apache-2.0"
+requires-python = ">=3.10"
+authors = [
+    { name = "Alex" }
+]
+keywords = ["mem0", "mcp", "memory", "llm", "ai", "server", "ollama", "local"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: Apache Software License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+
+dependencies = [
+    "mem0ai>=1.0.0",
+    "typer[all]>=0.12.0",
+    "fastapi>=0.115.0",
+    "uvicorn[standard]>=0.32.0",
+    "pydantic>=2.0.0",
+    "pydantic-settings>=2.0.0",
+    "pyyaml>=6.0.0",
+    "python-dotenv>=1.0.0",
+    "rich>=13.0.0",
+    "mcp>=1.0.0",
+    "httpx>=0.27.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0.0",
+    "pytest-asyncio>=0.24.0",
+    "ruff>=0.8.0",
+    "mypy>=1.13.0",
+]
+qdrant = ["qdrant-client>=1.12.0"]
+chroma = ["chromadb>=0.5.0"]
+pinecone = ["pinecone>=5.0.0"]
+ollama = ["ollama>=0.4.0"]
+
+[project.scripts]
+mem0-open-mcp = "mem0_server.cli:app"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/mem0_server"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B", "C4"]
+ignore = ["E501"]
+
+[tool.mypy]
+python_version = "3.10"
+strict = true
+ignore_missing_imports = true
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]

mem0_open_mcp-0.1.0/src/mem0_server/__init__.py

@@ -0,0 +1,8 @@
+"""
+mem0-server: Standalone MCP server for mem0 with web configuration UI.
+
+This package provides a CLI tool to run mem0 as an MCP server without Docker,
+with optional web UI for configuration management.
+"""
+
+__version__ = "0.1.0"

mem0_open_mcp-0.1.0/src/mem0_server/api/__init__.py

@@ -0,0 +1,5 @@
+"""API package for mem0-server."""
+
+from mem0_server.api.routes import create_api_router
+
+__all__ = ["create_api_router"]