返回 MCP 目录
public公开dns本地运行

memory-box-mcp

Memory Box MCP服务器为Cline和Claude Desktop提供与Memory Box实例交互的工具,支持语义记忆的保存、搜索和格式化。

article

README

🚀 如何在Cline中配置和使用Memory Box MCP服务:详细指南

本指南详细介绍了如何在Cline中配置和使用Memory Box MCP服务,帮助你快速上手并解决可能遇到的问题。

🚀 快速开始

安装与运行

依赖安装

执行以下命令安装项目依赖:

npm install

启动服务

依赖安装完成后,使用以下命令启动服务:

npm start

📦 安装指南

配置步骤

环境变量设置

编辑Cline配置文件,路径如下:

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

在该文件中添加以下内容:

"memory-box-mcp": {
  "command": "node",
  "args": [
    "<项目路径>/build/index.js"
  ],
  "env": {
    "MEMORY_BOX_API_URL": "https://你的Memory Box实例",
    "MEMORY_BOX_TOKEN": "你的令牌",
    "DEFAULT_BUCKET": "默认存储桶名称",
    "SYSTEM_PROMPT": "自定义系统提示内容"
  },
  "disabled": false,
  "autoApprove": []
}

💻 使用示例

系统提示的自定义

步骤:

  1. 打开终端,进入项目目录:
cd <项目路径>
  1. 查看当前系统提示
npm run prompt-helper -- view
  1. 重置为默认提示
npm run prompt-helper -- reset
  1. 验证自定义提示
npm run prompt-helper -- validate

📚 详细文档

其他配置选项

  • MEMORY_BOX_API_URL:指定Memory Box服务的URL。
  • MEMORY_BOX_TOKEN:用于身份验证的令牌。
  • DEFAULT_BUCKET:默认存储桶名称。

故障排除

  1. 确认令牌配置正确。
  2. 检查Memory Box服务是否正常运行且可访问。
  3. 查看Cline日志获取错误信息。

开发指南

步骤:

  1. 修改源代码位于:
<项目路径>/src/
  1. 重建服务:
npm run build
  1. 重启Cline以应用更改。
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端