持久记忆服务器

Memory Agent MCP Server 是一个为Claude Code提供持久记忆能力的服务器,通过智能信息存储和检索解决上下文窗口限制问题。

  • by AnsKM
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 anskm/memory-agent-mcp

使用说明

内存代理MCP服务器

MCP(模型上下文协议)服务器,为Claude Code提供持久内存功能,通过智能信息存储和检索解决上下文窗口限制。

特性

  • 🧠 持久存储器:存储和检索对话、代码片段和项目上下文
  • 🔍 语义搜索:使用向量嵌入查找相关信息
  • 🚀 快速检索:优化向量搜索的响应时间低于1000毫秒
  • 💾 项目隔离:不同项目的单独内存存储
  • 🔄 工作流内存:记住并回放多步骤流程
  • 📊 智能排名:多因素记忆排名(相关性、新近性、重要性)

建筑

构建于:

  • 快速 API:现代异步Python web框架
  • Qdrant:高性能矢量数据库
  • Voyage AI:最先进的嵌入模型
  • MCP协议:Anthropic的AI工具集成标准

快速开始

先决条件

  • Python 3.9+
  • Docker(可选,适用于Qdrant)
  • Voyage AI API键

安装

  1. 克隆存储库:
git clone https://github.com/yourusername/memory-agent-mcp.git
cd memory-agent-mcp
  1. 安装依赖项:
pip install -e .
  1. 设置环境变量:
cp .env.example .env
# Edit .env with your API keys
  1. 启动Qdrant(使用Docker):
docker run -p 6333:6333 qdrant/qdrant
  1. 运行MCP服务器:
memory-agent-mcp

与Claude Code集成

添加到您的Claude代码配置中:

claude mcp add memory "python /path/to/memory-agent-mcp/src/mcp/server.py"

用法

集成后,您可以使用Claude Code中的内存功能:

  • @memory recall "regex patterns" -查找过去的代码模式
  • @memory save-workflow "deployment" -保存多步骤流程
  • @memory project-context -获取项目特定信息

发展

运行测试

pytest

代码质量

# Format code
black src/

# Lint
ruff check src/

# Type check
mypy src/

成本

  • 最小设置:约12美元/月(2GB VPS)
  • 推荐:约27美元/月(4GB VPS+备份)
  • 嵌入:免费套餐覆盖大部分使用量

许可证

MIT许可证-有关详细信息,请参阅许可证文件

致谢

建在 记忆 框架。