mcp-external-memory

Name: mcp-external-memory
Author: daedalus

本地服务

github.com/daedalus记忆与知识027 周前更新

代码仓库

关于 mcp-external-memory

mcp-external-memory 是供大模型使用的 MCP 服务，用于持久化存储和搜索文本记忆。它支持命名空间和标签，并提供 TF-IDF、OpenAI 与 Ollama 嵌入后端。

主要功能

01存储、更新和删除记忆
02按语义搜索记忆
03获取或列出记忆
04按命名空间和标签筛选
05支持 TF-IDF、OpenAI 和 Ollama 嵌入

适用场景

01保存用户偏好以供后续检索
02按含义搜索已存笔记
03按命名空间或标签整理记忆

MCP 相关

提供存储、搜索、获取、列出、更新和删除记忆的工具，并可查询记忆统计信息。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "daedalus-mcp-external-memory": {
      "command": "uvx",
      "args": [
        "mcp-external-memory"
      ]
    }
  }
}

启动命令uvx mcp-external-memory

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypimcp-external-memory0.1.2stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

mcp-external-memory

一个 MCP 服务，为大模型提供持久化、可搜索的语义记忆。

安装

pip install mcp-external-memory

用法

from mcp_external_memory import memory_store, memory_search

# Store a memory
result = memory_store(content="Alice prefers dark mode", namespace="users", tags=["alice", "ui"])

# Search memories
results = memory_search(query="what does Alice prefer?", namespace="users")

命令行

mcp-external-memory --help

API

工具

工具	描述
`memory_store`	持久化文本，可选指定命名空间、标签和元数据
`memory_search`	对所有记忆进行语义搜索（余弦相似度）
`memory_get`	根据 ID 获取单条记忆
`memory_delete`	根据 ID 删除记忆
`memory_list`	列出记忆，可选按命名空间或标签筛选，并支持分页
`memory_stats`	记忆数量、命名空间数量和数据库路径
`memory_update`	更新现有记忆

嵌入后端

该服务支持多个嵌入后端：

TF-IDF（默认）：纯 Python 实现，无需外部依赖
OpenAI：使用 text-embedding-3-small 模型
Ollama：使用 Ollama 进行本地嵌入

通过 MEMORY_EMBED_BACKEND 环境变量设置。

开发

git clone https://github.com/daedalus/mcp-external-memory.git
cd mcp-external-memory
pip install -e ".[test]"

# run tests
pytest

# format
ruff format src/ tests/

# lint
ruff check src/ tests/

# type check
mypy src/