项目介绍
Memory MCP
这是一个使用低级服务器实现和SQLite存储来存储和检索记忆的Model Context Protocol服务器。
安装
该项目使用uv进行依赖管理，而不是pip。uv是一个快速、可靠的Python包安装器和解析器。
使用uv安装：
uv pip install memory-mcp
或者直接从源代码安装：
uv pip install .
对于开发：
uv pip install -e ".[dev]"
如果你没有安装uv，可以按照官方说明进行安装。
使用
运行服务器
memory-mcp
这将启动允许你存储和检索记忆的MCP服务器。
可用工具
Memory MCP提供了以下工具：
remember: 存储一个新的带有标题和内容的记忆get_memory: 通过ID或标题检索特定的记忆list_memories: 列出所有已存储的记忆update_memory: 更新现有的记忆delete_memory: 删除一个记忆
使用MCP Inspect调试
MCP提供了一个名为mcp inspect的命令行工具，可以让你直接调试和与你的MCP服务器交互。
设置
- 首先，确保已经安装了MCP CLI工具：
uv pip install mcp[cli]
- 在一个终端中启动Memory MCP服务器：
memory-mcp
- 在另一个终端中，使用
mcp inspect连接到正在运行的服务器：
mcp inspect
使用MCP Inspect
一旦连接，你可以：
列出可用工具
> tools
这将显示Memory MCP服务器提供的所有工具。
调用工具
要调用一个工具，使用call命令后跟工具名称和任何所需参数：
> 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 inspect终端中，使用
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