Memory Box MCP Server

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

相关项目

该 MCP 服务器设计用于与Memory Box 配合使用，Memory Box是一个由矢量嵌入驱动的语义记忆存储和检索系统。

Memory Box 提供了与该 MCP 服务器通信的后端 API，允许您：

• 使用向量嵌入存储记忆以进行语义搜索
• 将记忆整理到可自定义的存储桶中
• 根据含义而非关键词来搜索记忆
• 检索具有详细背景的记忆
• 寻找语义相关的记忆
• 跟踪内存处理状态

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

特征

• 保存记忆：将格式化的记忆连同源信息和元数据一起保存到您的记忆盒中
• 搜索记忆：使用语义搜索来搜索你的记忆
• 检索记忆：获取所有记忆或特定存储桶中的记忆
• 查找相关记忆：发现语义相似的记忆
• 检查记忆状态：监控记忆的处理状态
• 格式化记忆：根据结构化系统提示格式化记忆
• 使用情况统计：查看当前计划、使用情况指标和资源限制

安装

该服务器已安装并配置完毕，可供 Cline 使用。请注意，您需要一个正在运行的 Memory Box 实例（自托管或使用位于 memorybox.amotivv.ai 的托管版本）才能使用此 MCP 服务器。

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 Memory Box MCP Server：

要完成设置：

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 中使用以下工具：

节省内存

使用适当的格式将记忆保存到记忆盒：

参数：

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

搜索记忆

使用语义搜索来搜索记忆：

参数：

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

获取所有记忆

找回所有记忆：

获取桶中回忆

从特定存储桶中获取记忆：

参数：

• bucket_id （必需）：从中检索记忆的存储桶

格式化内存

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

参数：

• text （必需）：要格式化的文本
• type （可选）：记忆的类型（技术、决策、解决方案、概念、参考、应用、事实）（默认值：“技术”）

获取相关记忆

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

参数：

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

检查内存状态

检查内存的处理状态：

参数：

• memory_id （必需）：要检查状态的内存的 ID

获取使用情况统计

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

此工具返回：

• 当前计划信息（例如免费、基本、专业、旧版）
• 用户状态和限制执行信息
• 本月使用情况指标（商店操作、搜索操作、API 调用）
• 具有人类可读格式的数据处理量
• 根据您的计划的资源限制（如果适用）
• 按类型划分的运营情况

此操作不需要任何参数。

定制

系统提示自定义

Memory Box MCP 服务器使用系统提示符根据特定准则格式化内存。您可以自定义此提示符来更改内存的格式化方式。

默认系统提示符

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

如何自定义系统提示

自定义系统提示：

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": "Your custom system prompt here..." }, "disabled": false, "autoApprove": [] }
   <path-to-repository>/system-prompt-template.txt中提供了一个模板文件，您可以复制和修改它。
3. 重新启动 Cline 以应用更改

系统提示助手

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

其他配置选项

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

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

故障排除

如果您遇到问题：

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

发展

要对服务器进行更改：

1. 编辑<path-to-repository>/src/中的源代码
2. 重建服务器：
   cd <path-to-repository> npm run build
3. 重新启动 Cline 以应用更改