MemOS-MCP

# MemOS 命令行版本使用指南 ## 🎯 概述 这是基于原项目 [MemTensor/MemOS](https://github.com/MemTensor/MemOS) 的本地化部署版本，专注于**命令行使用**，提供完整的智能记忆管理功能。 ## ✨ 特色功能 - 🧠 **智能记忆管理**: 向量化存储和检索 - 🤖 **AI对话增强**: 基于DeepSeek-V3的智能对话 - 📝 **学习笔记管理**: 专业的学习内容组织 - 💼 **工作任务跟踪**: 高效的任务管理 - 🔍 **智能搜索**: 语义相似度搜索 - 💡 **个人助手**: 基于记忆的个性化服务 ## 🚀 快速开始 ### 1. 环境检查 确保系统已通过测试： ```bash poetry run python simple_test.py ``` ### 2. 启动命令行界面 ```bash poetry run python memos_cli.py ``` 这将显示一个友好的菜单界面： ``` ================================================== 🧠 MemOS 智能记忆管理系统 ================================================== 请选择功能: 1. 🧪 运行系统测试 2. 📝 基础功能演示 3. 🚀 高级功能演示 4. 💬 交互式AI对话 5. 🤖 智能助手模式 6. 📊 查看使用指南 0. 退出 ================================================== ``` ## 📖 功能详解 ### 🧪 系统测试 (选项1) 验证所有核心组件是否正常工作： - OpenAI库导入测试 - 基础依赖检查 - Qdrant向量数据库测试 - SiliconFlow API连接测试 ### 📝 基础功能演示 (选项2) 展示核心记忆管理功能： - 添加和搜索记忆 - AI对话（普通模式 vs 记忆增强模式） - 记忆列表查看 ### 🚀 高级功能演示 (选项3) 演示专业功能： - 学习笔记管理 - 工作任务跟踪 - 个人见解记录 - 智能总结生成 ### 💬 交互式AI对话 (选项4) 进入实时对话模式： - 输入 `add:内容` 添加记忆 - 输入 `quit` 退出 - 其他输入进行AI对话 ### 🤖 智能助手模式 (选项5) 功能最全面的交互模式： - `add:内容` - 添加记忆 - `learn:主题:内容` - 添加学习笔记 - `work:任务:优先级` - 添加工作任务 - `remind:查询` - 智能提醒 - `summary` - 学习总结 - `dashboard` - 工作仪表板 - `quit` - 退出 ## 💻 直接脚本使用 如果你更喜欢直接运行脚本： ```bash # 基础功能演示 poetry run python usage_examples.py # 高级功能演示 poetry run python advanced_examples.py # 系统测试 poetry run python simple_test.py ``` ## 🔧 配置说明 ### 环境变量配置 (.env文件) ```env # SiliconFlow API配置（推荐） SILICONFLOW_API_KEY=sk-ygqlrgrxrypykiiskuspuahkwihhbhhjhazqokntwdzfwqdv SILICONFLOW_BASE_URL=https://api.siliconflow.cn/v1 # OpenAI兼容配置 OPENAI_API_KEY=sk-ygqlrgrxrypykiiskuspuahkwihhbhhjhazqokntwdzfwqdv OPENAI_BASE_URL=https://api.siliconflow.cn/v1 ``` ### 数据存储 - 记忆数据存储在各自的目录中（如 `./memos_data/`） - 向量数据库文件在 `./memos_data/vectors/` - 支持多个独立的数据目录 ## 🎯 使用场景 ### 1. 个人知识管理 ```bash # 启动智能助手模式 poetry run python memos_cli.py # 选择 5 -> 智能助手模式 # 使用 learn:Python:学习了装饰器的用法 ``` ### 2. 工作任务管理 ```bash # 添加工作任务 work:完成项目文档:high # 查看工作仪表板 dashboard ``` ### 3. 智能对话助手 ```bash # 启动交互式对话 poetry run python memos_cli.py # 选择 4 -> 交互式AI对话 # 先添加一些个人信息，然后进行对话 ``` ## 📊 性能特点 - ✅ **轻量化部署**: 无需GPU，使用远程LLM - ✅ **快速响应**: 本地向量搜索 + 远程AI推理 - ✅ **低成本**: SiliconFlow API价格优惠 - ✅ **高质量**: DeepSeek-V3模型提供专业回答 - ✅ **可扩展**: 模块化设计，易于定制 ## 🔍 故障排除 ### 常见问题 1. **API连接失败** ```bash # 检查网络和API密钥 poetry run python simple_test.py ``` 2. **依赖问题** ```bash # 重新安装依赖 poetry install ``` 3. **数据库锁定** ```bash # 清理数据目录 rm -rf ./memos_data ./api_data ``` ## 📈 下一步 1. **熟悉基础功能**: 从系统测试开始 2. **尝试演示**: 运行基础和高级演示 3. **实际使用**: 使用智能助手模式管理你的记忆 4. **定制化**: 根据需要修改配置和功能 ## 🎉 总结 这个MemOS命令行版本为你提供了： - 🖥️ **简洁的命令行界面** - 🧠 **完整的记忆管理功能** - 🤖 **智能AI对话能力** - 📊 **实用的管理工具** 相比原项目的纯SDK方式，这个版本更加用户友好，提供了直观的菜单界面和交互式操作，让你可以立即开始使用MemOS的强大功能！ --- **开始你的智能记忆管理之旅**： ```bash poetry run python memos_cli.py ```