内存盒-mcp

<p align="center"> <img src="https://gips2.baidu.com/it/u=3012911732,44274907&fm=3081&app=3081&f=PNG?w=1024&h=1024" alt="Memory Box Logo" width="200"/> </p> <h1 align="center">Memory Box MCP 服务器</h1> <p align="center"> Cline 和 Claude Desktop 的 MCP 集成，用于 Memory Box —— 使用语义理解保存、搜索和格式化记忆 </p> <p align="center"> <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT"></a> </p> <p align="center"> <a href="https://glama.ai/mcp/servers/wtbejx9zwc"> <img width="380" height="200" src="https://gips3.baidu.com/it/u=3482997738,2307207832&fm=3081&app=3081&f=PNG?w=760&h=400" /> </a> </p>

此 MCP 服务器提供了与 Memory Box 实例交互的工具，允许您通过 Cline 和 Claude Desktop 直接使用语义搜索来保存和搜索记忆。

相关项目

此 MCP 服务器旨在与 Memory Box 一起工作，这是一个由向量嵌入驱动的语义记忆存储和检索系统。

Memory Box 提供了此 MCP 服务器通信的后端 API，使您可以：

• 使用向量嵌入存储记忆以进行语义搜索
• 将记忆组织到可定制的桶中
• 根据意义而不是关键词搜索记忆
• 检索具有详细上下文的记忆
• 查找语义相关记忆
• 跟踪记忆处理状态

有关 Memory Box 的更多信息，包括如何设置自己的实例，请访问 Memory Box 网站。

功能

• 保存记忆：将格式化的记忆连同源信息和元数据保存到您的 Memory Box 中
• 搜索记忆：使用分页和日期排序的语义搜索来搜索您的记忆
• 检索记忆：获取所有记忆或特定桶中的记忆
• 桶管理：创建和删除桶以组织记忆
• 记忆管理：更新或删除现有记忆
• 查找相关记忆：发现语义相似的记忆
• 检查记忆状态：监控您的记忆处理状态
• 格式化记忆：根据结构化系统提示格式化记忆
• 使用统计：查看当前计划、使用指标和资源限制

安装

该服务器已安装并配置为与 Cline 一起使用。请注意，您需要一个正在运行的 Memory Box 实例（无论是自托管还是使用托管版本 memorybox.amotivv.ai）才能使用此 MCP 服务器。

作为 Claude Desktop 扩展安装（推荐）

使用 Memory Box 最简单的方法是通过桌面扩展：

1. 从 发布页面 下载最新的 memory-box.mcpb 文件
2. 打开 Claude Desktop
3. 前往 设置 > 扩展
4. 点击“从文件安装”
5. 选择下载的 memory-box.mcpb 文件
6. 在扩展设置中配置您的 Memory Box API 令牌

扩展程序会自动配置所有必要的环境变量和工具。

通过 Smithery 安装

要通过 Smithery 自动安装 Memory Box MCP 服务器：

npx -y @smithery/cli install @amotivv/memory-box-mcp --client claude

完成设置：

1. 编辑 Cline MCP 设置文件：

   ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
   

2. 将您的 Memory Box 令牌添加到 MEMORY_BOX_TOKEN 环境变量中：

   "memory-box-mcp": {
     "command": "node",
     "args": [
       "<path-to-repository>/build/index.js"
     ],
     "env": {
       "MEMORY_BOX_API_URL": "https://memorybox.amotivv.ai",
       "MEMORY_BOX_TOKEN": "your-token-here",
       "DEFAULT_BUCKET": "General"
     },
     "disabled": false,
     "autoApprove": []
   }
   

3. 可选地，您可以通过更改 DEFAULT_BUCKET 值来自定义默认桶。

使用

配置完成后，您可以在 Cline 中使用以下工具：

保存记忆

将记忆保存到 Memory Box 并正确格式化：

使用 save_memory 工具保存关于向量数据库的信息："像 pgvector 这样的向量数据库存储和查询高维向量用于语义搜索应用。"

参数：

• text（必需）：要保存的记忆内容
• bucket_id（可选）：要保存记忆的桶（默认：“General”）
• format（可选）：是否根据系统提示格式化记忆（默认：true）
• type（可选）：记忆类型（TECHNICAL, DECISION, SOLUTION, CONCEPT, REFERENCE, APPLICATION, FACT）用于格式化（默认：“TECHNICAL”）
• source_type（可选）：记忆来源类型（默认：“llm_plugin”）
• reference_data（可选）：关于记忆来源和上下文的附加元数据

搜索记忆

使用语义搜索搜索记忆：

使用 search_memories 工具查找关于“向量数据库”的信息

参数：

• query（必需）：搜索查询
• debug（可选）：在结果中包含调试信息（默认：false）

获取所有记忆

检索所有记忆：

使用 get_all_memories 工具显示我保存的所有记忆

获取桶记忆

获取特定桶中的记忆：

使用 get_bucket_memories 工具显示“学习”桶中的记忆

参数：

• bucket_id（必需）：要检索记忆的桶

格式化记忆

根据记忆系统提示格式化文本而不保存：

使用 format_memory 工具格式化此文本："像 pgvector 这样的向量数据库存储和查询高维向量用于语义搜索应用。"

参数：

• text（必需）：要格式化的文本
• type（可选）：记忆类型（TECHNICAL, DECISION, SOLUTION, CONCEPT, REFERENCE, APPLICATION, FACT）（默认：“TECHNICAL”）

获取相关记忆

查找与特定记忆语义相似的记忆：

使用 get_related_memories 工具与记忆 ID 123

参数：

• memory_id（必需）：要查找相关记忆的记忆 ID
• min_similarity（可选）：相关记忆的最小相似度阈值（0.0-1.0）（默认：0.7）

检查记忆状态

检查记忆的处理状态：

使用 check_memory_status 工具与记忆 ID 123

参数：

• memory_id（必需）：要检查状态的记忆 ID

获取使用统计

检索用户使用统计和计划信息：

使用 get_usage_stats 工具显示我的当前计划和使用指标

此工具返回：

• 当前计划信息（例如，免费、基础、专业、遗产）
• 用户状态和限制执行信息
• 当月使用指标（存储操作、搜索操作、API 调用）
• 以人类可读格式表示的数据处理量
• 基于您的计划的资源限制（如适用）
• 按类型的操作细分

此操作不需要任何参数。

获取桶

列出所有可用桶：

使用 get_buckets 工具显示所有可用桶

此工具返回所有桶的列表，包括它们的名称、ID、记忆数量和创建日期。

创建桶

创建一个新的桶来组织记忆：

使用 create_bucket 工具创建名为“项目想法”的桶

参数：

• bucket_name（必需）：要创建的桶名称

删除桶

删除现有的桶：

使用 delete_bucket 工具删除名为“旧笔记”的桶

参数：

• bucket_name（必需）：要删除的桶名称
• force（可选）：即使桶包含记忆也强制删除（默认：false）

更新记忆

更新现有记忆的内容、桶或元数据：

使用 update_memory 工具更新记忆 ID 123 的新文本："更新关于向量数据库的信息"

参数：

• memory_id（必需）：要更新的记忆 ID
• text（可选）：记忆的新文本内容
• bucket_id（可选）：记忆的新桶
• reference_data（可选）：更新的参考数据，包括关系

删除记忆

删除特定记忆：

使用 delete_memory 工具删除记忆 ID 123

参数：

• memory_id（必需）：要删除的记忆 ID

自定义

系统提示自定义

Memory Box MCP 服务器使用系统提示来根据特定指南格式化记忆。您可以自定义此提示以改变记忆的格式方式。

默认系统提示

默认系统提示包括不同类型的记忆格式指南：

您是一个有用的 AI 助手。当使用 Memory Box 存储记忆时，请遵循这些增强的格式指南：

1. 结构：根据信息类型格式化记忆：
   - 技术： "TECHNICAL - [简短主题]：[具体细节的简洁解释]"
   - 决策： "DECISION - [简短主题]：[决策]因为[理由]。考虑的替代方案：[选项]"
   - 解决方案： "SOLUTION - [问题概述]：[解决该问题的实施细节]"
   - 概念： "CONCEPT - [主题]：[概念的清晰解释，附带示例]"
   - 参考： "REFERENCE - [主题]：[URL、工具名称或资源]用于[特定目的]"
   - 应用： "APPLICATION - [应用名称]：[用户友好的描述]接着是[技术实现细节]"

2. 格式指南：
   - 创建专注的记忆：每个记忆应包含单一清晰的概念或主题
   - 使用多样化的术语：包括技术术语和用户友好的替代词
   - 包含可搜索的关键词：以用户可能搜索的常见词开头
   - 平衡细节层次：包括高层次描述和关键的技术细节
   - 长度：保持记忆在 50-150 字之间
   - 始终在 YYYY-MM-DD 格式下包含当前日期

3. 记忆存储参数：
   - 使用 "text" 参数存储您的格式化记忆内容
   - 设置 "source_type" 为 "llm_plugin"
   - 包括适当的 "reference_data" 以提供源信息和上下文

4. 参考数据结构：
   - source.platform：标识您的平台（例如，“claude_desktop”，“cline”）
   - source.type：始终设置为 "llm_plugin"
   - source.version：可选版本信息
   - context.conversation_id：如有，包括以链接相关的对话记忆
   - context.message_id：可选的消息特定标识符

5. 特殊格式：
   - 对于用户事实、偏好或个人信息："YYYY-MM-DD: FACT: [用户] [特定偏好/属性/信息]"
   - 对于参考资料：包括找到信息的具体细节

6. 相关记忆：在搜索找到记忆后，使用 get_related_memories 工具和搜索结果中的 memory_id 查找是否有相关记忆。呈现这些额外的记忆以提供更多上下文。
   
7. 检索考虑：在存储重要记忆之前，请考虑："以后可能会使用哪些搜索词来找到这些信息？" 并确保这些词被包含。

如何自定义系统提示

要自定义系统提示：

1. 编辑 Cline MCP 设置文件：

   ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
   

2. 将您的自定义系统提示添加到 SYSTEM_PROMPT 环境变量中：

   "memory-box-mcp": {
     "command": "node",
     "args": [
       "<path-to-repository>/build/index.js"
     ],
     "env": {
       "MEMORY_BOX_API_URL": "https://your-memory-box-instance",
       "MEMORY_BOX_TOKEN": "your-token-here",
       "DEFAULT_BUCKET": "General",
       "SYSTEM_PROMPT": "您的自定义系统提示在这里..."
     },
     "disabled": false,
     "autoApprove": []
   }
   

   提供了一个模板文件 <path-to-repository>/system-prompt-template.txt，您可以复制并修改它。

3. 重启 Cline 以应用更改

系统提示助手

Memory Box MCP 服务器包含一个用于管理系统提示的辅助脚本：

# 查看当前系统提示
cd <path-to-repository>
npm run prompt-helper -- view

# 重置为默认系统提示
cd <path-to-repository>
npm run prompt-helper -- reset

# 验证自定义系统提示
cd <path-to-repository>
npm run prompt-helper -- validate

其他配置选项

您还可以自定义这些环境变量：

• MEMORY_BOX_API_URL：您的 Memory Box 实例的 URL
• MEMORY_BOX_TOKEN：您的 Memory Box 身份验证令牌
• DEFAULT_BUCKET：保存记忆时使用的默认桶

故障排除

如果您遇到问题：

1. 检查您的 Memory Box 令牌是否正确配置
2. 验证您的 Memory Box 实例是否正在运行且可访问
3. 检查 Cline 日志中的任何错误消息

开发

要对服务器进行更改：

1. 编辑 <path-to-repository>/src/ 中的源代码
2. 重新构建服务器：

   cd <path-to-repository>
   npm run build
   

3. 重启 Cline 以应用更改

构建桌面扩展

要构建桌面扩展程序包：

1. 安装依赖项：

   npm install
   

2. 构建扩展：

   npm run build-extension
   

3. 构建的扩展将在 dist/memory-box.mcpb 中可用

发布流程

1. 更新 package.json 中的版本
2. 更新 CHANGELOG.md 中的新更改
3. 提交更改
4. 创建新的 GitHub 发布
5. 将 memory-box.mcpb 文件作为发布资产上传