使用说明

项目简介

myAI Memory Sync MCP 服务器是一个基于 Model Context Protocol (MCP) 的后端应用，旨在帮助用户在不同的 Claude 界面（如 Claude Desktop, Claude.ai 网页版, Windsurf）之间同步和管理个人化的“记忆模板”。它通过标准化的 MCP 协议，让 Claude 等 LLM 能够跨平台地访问和利用用户定义的个人信息、偏好设置等上下文数据，从而实现更一致和个性化的 AI 交互体验。

主要功能点

跨平台记忆同步: 自动将您的“myAI Memory”模板同步到 Claude Desktop, Claude.ai 网页版和 Windsurf 等多个平台，无需手动复制粘贴。
模板化记忆管理: 使用 Markdown 格式组织和编辑您的个人记忆模板，支持分章节管理，例如“用户信息”、“通用回复风格”等。
自然语言指令: 支持通过自然语言指令（如“Use myAI Memory to remember...”）更新记忆，服务器会自动解析并更新到模板的相应章节。
MCP 标准工具: 提供 'get_template', 'get_section', 'update_section', 'sync_platforms' 等标准 MCP 工具，方便客户端进行高级操作。
预设模板: 支持加载和创建预设模板，快速切换不同的记忆配置。
多种传输协议: 支持 Stdio 和 HTTP/SSE 两种传输协议，兼容 Claude Desktop 和远程连接。

安装步骤

克隆仓库

git clone https://github.com/Jktfe/myAImemory-mcp.git
cd myAImemory-mcp

安装依赖
```
npm install
```
构建项目
```
npm run build
```

服务器配置

Claude Desktop MCP 服务器配置 (JSON):

{
  "myai-memory-sync": {
    "command": "/path/to/myAImemory-mcp/direct-mcp-server.sh",
    "transport": "stdio"
  }
}

配置参数说明:

'"myai-memory-sync"': MCP 服务器名称，可以自定义。
'"command"': MCP 服务器启动命令脚本的绝对路径。请将 '/path/to/myAImemory-mcp' 替换为您仓库的实际路径。
'"transport"': 传输协议，Claude Desktop 使用 'stdio'。

注意:

请确保将 '/path/to/myAImemory-mcp/direct-mcp-server.sh' 替换为 'direct-mcp-server.sh' 脚本在您本地文件系统中的 绝对路径。
'direct-mcp-server.sh' 脚本通常位于克隆仓库的根目录下。

Claude.ai 网页版同步 (可选):

要启用 Claude.ai 网页版同步功能，您需要设置以下环境变量：

export CLAUDE_WEB_SYNC_ENABLED=true
export CLAUDE_WEB_HEADLESS=true  # 可选，设置为 false 以显示浏览器界面
export [email protected] # 可选，用于自动登录

基本使用方法

启动 MCP 服务器 (stdio 传输，用于 Claude Desktop):

./start-memory-sync.sh

或者直接使用 CLI 命令：

node --loader ts-node/esm src/cli.ts --stdio

在 Claude Desktop 中配置 MCP 服务器:
- 打开 Claude Desktop 客户端。
- 进入 "Settings" (设置) -> "Developer" (开发者) 选项卡。
- 在 "MCP Servers" (MCP 服务器) 部分，点击 "Add Server" (添加服务器)。
- 复制上面提供的 Claude Desktop MCP 服务器配置 (JSON) 代码，粘贴到配置框中。
- 确保配置中的 '"command"' 路径正确指向您的 'direct-mcp-server.sh' 脚本。

使用自然语言指令更新记忆 (示例):

在 Claude 中，您可以使用以下自然语言指令来更新您的记忆：

Use myAI Memory to remember I prefer dark mode in my code editors.

Use myAI Memory to add to Travel Preferences I prefer window seats on flights.

Update my Food Preferences to include that I love spicy food.

服务器会自动解析这些指令，并将信息添加到您的记忆模板中，并同步到配置的 Claude 平台。

使用标准 MCP 工具 (高级用法):

您可以使用标准 MCP 工具进行更精细的操作，例如：

Use myai-memory-sync__get_template

Use myai-memory-sync__update_section with:
sectionName: "User Information"
content: "I work at New Model VC"

这些工具提供了更底层的控制，例如直接获取模板、更新特定章节等。

注意事项

首次使用或配置更改后，建议重启 Claude Desktop 客户端以确保 MCP 服务器配置生效。
如果遇到同步问题，可以尝试运行 'emergency-sync.sh' 脚本进行紧急同步。
详细配置和高级用法请参考仓库 README 文档。

关键词