{
  "markdown": "# mcp-external-memory\n\n> An MCP server that gives LLMs persistent, searchable semantic memory.\n\n[![PyPI](https://img.shields.io/pypi/v/mcp-external-memory.svg)](https://pypi.org/project/mcp-external-memory/)\n[![Python](https://img.shields.io/pypi/pyversions/mcp-external-memory.svg)](https://pypi.org/project/mcp-external-memory/)\n[![Coverage](https://codecov.io/gh/daedalus/mcp-external-memory/branch/main/graph/badge.svg)](https://codecov.io/gh/daedalus/mcp-external-memory)\n[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)\n\n## Install\n\n```bash\npip install mcp-external-memory\n```\n\n## Usage\n\n```python\nfrom mcp_external_memory import memory_store, memory_search\n\n# Store a memory\nresult = memory_store(content=\"Alice prefers dark mode\", namespace=\"users\", tags=[\"alice\", \"ui\"])\n\n# Search memories\nresults = memory_search(query=\"what does Alice prefer?\", namespace=\"users\")\n```\n\n## CLI\n\n```bash\nmcp-external-memory --help\n```\n\n## API\n\n### Tools\n\n| Tool | Description |\n|------|-------------|\n| `memory_store` | Persist text + optional namespace/tags/metadata |\n| `memory_search` | Semantic search (cosine similarity) over all memories |\n| `memory_get` | Retrieve a single memory by ID |\n| `memory_delete` | Delete a memory by ID |\n| `memory_list` | List memories with optional namespace/tag filter + pagination |\n| `memory_stats` | Count of memories, namespaces, DB path |\n| `memory_update` | Update an existing memory |\n\n### Embedding Backends\n\nThe server supports multiple embedding backends:\n\n- **TF-IDF** (default): Pure Python, no external dependencies\n- **OpenAI**: Uses `text-embedding-3-small` model\n- **Ollama**: Local embeddings with Ollama\n\nSet via `MEMORY_EMBED_BACKEND` environment variable.\n\n## Development\n\n```bash\ngit clone https://github.com/daedalus/mcp-external-memory.git\ncd mcp-external-memory\npip install -e \".[test]\"\n\n# run tests\npytest\n\n# format\nruff format src/ tests/\n\n# lint\nruff check src/ tests/\n\n# type check\nmypy src/\n```\n\n## MCP Registry\n\nmcp-name: io.github.daedalus/mcp-external-memory\n",
  "bytes": 2129,
  "sha": "0033c1b594ab5237e398c649f0d2a3e296b33da3c275555f2e22942c12c37f8f",
  "repo_slug": "daedalus/mcp-external-memory",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_daedalus_mcp_external_memory_322a5e66/readme"
}