项目介绍
<table>
<tr>
<td>
<img src="assets/image/memcord_1024.png" width="256">
</td>
<td>
<h3>MEMCORD v2.3.3 (mcp 服务器)</h3>
<p>
这款以隐私为中心、自托管的MCP服务器帮助您整理聊天历史记录，总结消息，并通过AI搜索过去的聊天记录——同时确保所有内容的安全并完全由您控制。
</p>
</td>
</tr>
</table>
再也不丢失上下文
将您的Claude对话转换成一个可搜索的知识库，随着您的成长而增长。
✨ 核心优势
- 🧠 无限记忆 - Claude记住所有无限制的对话，并通过智能自动总结功能进行记忆
- 🔒 您的数据，您的控制 - 100%本地存储，零云依赖或隐私问题
- 🎯 轻松组织 - 智能标签和文件夹围绕您的工作流程自我组织
- 🔗 智能合并 - 自动合并相关对话，同时消除重复项
v2.3.3 新增内容
优化以提高速度，减少启动时间，改进代码维护性而不破坏更改：
- 工具定义缓存以消除冗余的list_tools()调用
- 对于重型依赖（TextSummarizer, SimpleQueryProcessor, ContentImporter, MemorySlotMerger）使用@property装饰器实现懒加载，以加快启动速度
- 错误消息常量以消除30多个重复字符串字面量并提高可维护性
- 使用@functools.lru_cache对_get_mime_type()进行LRU缓存，以便更快地重复查找
🚀 快速开始
curl -fsSL https://github.com/ukkit/memcord/raw/main/install.sh | bash
这将：
- 下载并设置 memcord
- 使用uv设置Python虚拟环境
- 更新 claude_desktop_config.json & README.md 安装路径
Claude 桌面/VSCode
{
"mcpServers": {
"memcord": {
"command": "uv",
"args": [
"--directory",
"</path/to/memcord>",
"run",
"memcord"
],
"env": {
"PYTHONPATH": "</path/to/memcord>/src"
}
}
}
}
Claude Code MCP (🧪 测试版)
为您的项目添加MCP服务器 - 查看README.md获取安装路径
claude mcp add-json memcord '{"type":"stdio","command":"uv","args":["--directory","</path/to/memcord>","run","memcord"],"env":{"PYTHONPATH":"</path/to/memcord>/src"}}'
验证安装
claude mcp list
claude mcp get memcord
在您的CLAUDE.md文件顶部添加
memcord_name "您的项目名称"
手动安装
# 传统安装方法
git clone https://github.com/ukkit/memcord.git
cd memcord
uv venv
source .venv/bin/activate
uv pip install -e .
# 将 claude_desktop_config.json 中的 </path/to/memcord/> 替换为您手动安装的位置
完整安装指南 - 详细设置说明，适用于Claude Code、Claude Desktop和其他MCP应用程序。
💻 基本使用
# 创建一个内存槽并保存对话
memcord_name "项目会议"
memcord_save "关于我们新API设计的讨论..."
memcord_save_progress
# 使用现有内存槽
memcord_use "项目会议" 🆕
# 导航时间线 - 选择特定条目
memcord_select_entry "两小时前" # 或 "最新", 索引, 时间戳 🆕
# 隐私控制 - 启用零模式（不保存）
memcord_zero # 直到切换到另一个槽位，否则不会保存任何记忆
# 搜索和查询您的记忆
memcord_search "API设计决策"
memcord_query "我们关于认证决定的是什么？"
# 合并相关对话
memcord_merge ["项目会议", "api_notes"] "综合项目" 🆕
参考 📖 完整工具参考 获取高级模式及所有19个工具的详细文档，包括示例和参数。
📚 文档
<details><summary>⚠️ 文档更新中 </summary>- 📚 安装指南 - 所有MCP应用程序的完整设置说明
- 📃 功能指南 - 功能完整列表
- 📖 工具参考 - 所有19个工具的详细文档
- 📥 导入与合并指南 - 第三阶段功能的全面指南 🆕
- 🔍 搜索与查询指南 - 高级搜索功能和自然语言查询
- 🗂️ 使用示例 - 实际工作流和实用案例
- ⚙️ 数据格式规范 - 技术细节和文件格式
- 🛠️ 故障排除 - 常见问题及其解决方案
💎 如果您发现这个项目有用，请考虑：
- 🌟 在GitHub上给仓库加星
- 🤝 支持开发
- 🐛 报告错误和提出功能建议
MIT 许可证 - 详情见LICENSE文件。