🚀 记忆 MCP 服务器
记忆 MCP 服务器是一个基于模型上下文协议（Model Context Protocol）的服务器，它借助低级服务实现和 SQLite 存储，来完成记忆的存储与检索工作。
🚀 快速开始
启动 MCP 服务器，即可开始存储和检索记忆：
memory-mcp
✨ 主要特性
- 便捷的依赖管理：使用 uv 进行依赖管理，而非传统的 pip，uv 是快速且可靠的 Python 包安装程序和解析器。
- 丰富的工具支持：提供
remember、get_memory、list_memories、update_memory、delete_memory等工具，满足存储、检索、更新和删除记忆等多种操作需求。 - 强大的调试功能：MCP 提供
mcp inspect命令行工具，方便直接调试和与 MCP 服务器交互，还可启用调试模式查看详细的请求和响应信息。
📦 安装指南
此项目使用 uv 进行依赖管理。如果你没有安装 uv，请按照 官方说明 安装。
使用 uv 安装
uv pip install memory-mcp
直接从源代码安装
uv pip install .
开发时安装
uv pip install -e ".[dev]"
💻 使用示例
运行服务器
memory-mcp
可用工具
Memory MCP 提供以下工具：
remember：存储一个新的记忆，带有标题和内容get_memory：通过 ID 或标题检索特定记忆list_memories：列出所有存储的记忆update_memory：更新现有记忆delete_memory：删除一条记忆
使用 MCP 检查进行调试
设置
- 安装 MCP CLI 工具：
uv pip install mcp[cli]
- 在一个终端中启动 Memory MCP 服务器：
memory-mcp
- 在另一个终端中，使用
mcp inspect连接到运行中的服务器：
mcp inspect
使用 MCP 检查
连接后，可执行以下操作：
列出可用工具
> tools
调用工具
> call remember title="会议记录" content="讨论了项目的时间表和关键里程碑。"
> call list_memories
> call get_memory memory_id=1
> call update_memory memory_id=1 title="更新后的标题" content="更新后的内容。"
> call delete_memory memory_id=1
开发模式
> debug on
探索工具架构
> tool remember
故障排除
如果遇到问题：
- 检查正在运行服务器的终端中的服务器日志，获取任何错误信息。
- 在 MCP 检查终端中启用调试模式
debug on，以查看原始请求和响应。 - 确保工具参数与预期架构匹配（使用
tool命令进行检查）。 - 如果服务器崩溃，请检查运行服务器的终端中的任何未捕获异常。
🔧 技术细节
开发贡献
要为项目做出贡献，请安装开发依赖项：
uv pip install -e ".[dev]"
管理依赖项
此项目使用 uv.lock 文件来锁定依赖项。要更新依赖项：
uv pip compile pyproject.toml -o uv.lock
运行测试
python -m pytest
代码格式化
black memory_mcp tests
溶剂检查
ruff check memory_mcp tests
类型检查
mypy memory_mcp