集成

与主流 Agent 框架、IDE、聊天客户端的集成方式。

为你已经建好的智能体框架、编码工具与语音管道加上持久记忆。下面每一条都走公开的 MCP 面或 Python SDK —— 没有分叉的客户端，也没有厂商插件。

Claude Code（MCP · stdio）

连上就出现 52 个工具。智能体在会话之间记住决策，不需要被重新告知。

claude mcp add mnemosyne -- python -m mnemosyne.webui.mcp_server --brain-dir ./mem

DeepSeek Harness（MCP · stdio）

Patch 式部署：宿主配置只增补不覆盖，改动可回退。

python -m mnemosyne.webui.mcp_server --brain-dir ./mem --namespace dsh

Hermes Agent（MCP · stdio）

常驻智能体获得一层跨越它所有会话的长期记忆。

python -m mnemosyne.webui.mcp_server --brain-dir ./mem --namespace hermes

Codex（MCP · stdio）

任何支持 MCP 的命令行智能体都能挂上同一个服务端；工具面里没有宿主专属的东西。

python -m mnemosyne.webui.mcp_server --brain-dir ./mem

OpenWebUI（MCP · HTTP）

地址指向 Streamable HTTP 网关，带上 Bearer 令牌。对话前端从此不再忘记它在跟谁说话。

python -m mnemosyne.webui.mcp_server --http --brain-dir ./mem --port 8788

任何 MCP 宿主（MCP · HTTP）

Streamable HTTP 是一次部署唯一需要对外暴露的端口，网络面因此收敛为一个。

# PowerShell
$env:MNEMOSYNE_MCP_TOKEN="<token>"
python -m mnemosyne.webui.mcp_server --http --port 8788
# macOS / Linux
MNEMOSYNE_MCP_TOKEN="<token>" python -m mnemosyne.webui.mcp_server --http --port 8788

LangChain（Python SDK）

可运行示例：把 MemoryBrain 作为检索与记忆组件接进链里。

python examples/langchain_integration.py

Ollama（本地模型）

全本地闭环 —— 本地模型加本地记忆，没有任何请求离开这台机器。

python examples/ollama_integration.py

进程内嵌入（Python SDK）

直接把 brain 导进你自己的进程。没有守护进程、没有端口、没有 IPC。

from mnemosyne import MemoryBrain; MemoryBrain("./mem").ensure_init()

插件目录（插件 SDK）

八个带文档的插件 —— numpy、qdrant、reranker、crypto、hrr、async、context-engine 与 SDK 本身。

# PowerShell
$env:MNEMOSYNE_PLUGINS="numpy_vector,reranker"
python -m mnemosyne.webui.web_server
# macOS / Linux
MNEMOSYNE_PLUGINS=numpy_vector,reranker python -m mnemosyne.webui.web_server