我的记忆-mcp

Name: 我的记忆-mcp
Author: Jktfe

作者：Jktfe9 星标更新：2025-03-25

安装使用来源：spider==github.com

项目介绍

myAI Memory Sync

厌倦了每次开始新聊天时都必须向Claude重复同样的信息吗？ myAI Memory Sync 是一个革命性的MCP工具，可以无缝同步您的偏好、个人信息和代码标准到所有Claude界面！只需更新一次，更改就会立即出现在Claude桌面、Claude代码、Windsurf以及Claude.ai网页上。借助我们先进的缓存系统，与记忆相关的查询速度可提高2000倍！停止浪费令牌在重复指令上，享受真正个性化的AI体验。

myAImemory-mcp与其他记忆工具的比较

虽然有许多优秀的AI系统记忆工具，但myAImemory-mcp作为模型上下文协议（MCP）工具，具有特定的目的：

工具	主要关注点	隐私模式	集成	独特优势
myAImemory-mcp	跨Claude界面的用户偏好	本地优先，不将数据发送到外部服务器	特定于Claude的MCP	跨平台同步，高性能缓存
Graphiti	时间知识图谱	依赖数据库	通用代理框架	知识表示中的时间感知
Letta/MemGPT	有状态代理框架	基于服务器	多模型支持	完整的代理架构
Mem0	个性化AI交互	基于API	多平台	多级记忆层次结构
Memary	人类记忆的代理	图数据库	专注于代理	人类记忆模拟
Cognee	可靠的AI应用记忆	多种存储选项	数据管道聚焦	广泛的数据源集成

myAImemory-mcp的关键优势：

隐私第一：所有数据保留在您的设备上，不会将个人信息发送到外部服务器
性能：利用Claude的缓存能力实现显著的速度提升
简单性：通过自然语言更新您在所有Claude界面的偏好
MCP集成：专为Claude MCP设计，实现无缝集成

🚀 快速开始

# 克隆仓库
git clone https://github.com/Jktfe/myaimemory-mcp.git
cd myaimemory-mcp

# 安装依赖
npm install

# 构建TypeScript代码
npm run build

# 启动MCP服务器（使用stdio传输）
npm start

# 或者使用HTTP传输启动
npm run start:http

🧠 服务器选项

统一的服务器脚本支持多种选项：

# 使用stdio传输启动（默认）
./start-server.sh

# 使用HTTP传输启动
./start-server.sh --http

# 在自定义端口上使用HTTP传输启动
./start-server.sh --http --port=8080

# 使用直接实现（无SDK）
./start-server.sh --direct

# 使用直接实现和HTTP传输启动
./start-server.sh --direct --http

# 启用调试模式
./start-server.sh --debug

🔄 直接同步方法（简单替代方案）

对于不需要运行MCP服务器的更简单的方法，您可以使用统一的CLI：

# 一次性同步所有记忆文件
npm run sync

# 或紧急同步（修复权限）
npm run sync:emergency

此脚本将：

从您的“myAI Master.md”文件读取
更新您项目中的所有CLAUDE.md文件
更新您的Windsurf记忆设置
所有操作都不会将敏感信息存储在git仓库中

🔒 隐私和安全

包含您个人信息的“myAI Master.md”文件被排除在git跟踪之外
所有CLAUDE.md文件也被排除以保护您的隐私
使用包含的.gitignore确保敏感文件保持私密

🗣️ 支持的自然语言命令

您可以使用这些自然语言模式与myAI Memory互动：

命令模式	示例	目的
`使用myAI Memory记住[信息]`	“使用myAI Memory记住我更喜欢TypeScript而不是JavaScript”	根据内容将信息添加到适当的部分
`记住[信息]`	“记住我住在伦敦”	添加信息到记忆的较短替代方式
`添加到我的记忆中[信息]`	“添加到我的记忆中我有两辆车”	另一种添加信息到记忆的方式
`使用myAI Memory添加到[部分][信息]`	“使用myAI Memory添加到编码偏好我更喜欢暗模式”	将信息添加到特定部分
`更新我的[部分]包括[信息]`	“更新我的用户信息包括我的生日是3月29日”	更新特定部分的新信息

注意：要跨所有平台进行完全同步，请使用命令行：node sync-memory.js

您：使用myAI Memory记住我更喜欢TypeScript而不是JavaScript
Claude：✅已添加到您的编码偏好！我会记住您更喜欢TypeScript而不是JavaScript。

📋 安装选项

选项1：直接安装（推荐）

从npm安装：

npm install -g myai-memory-sync

启动服务器：

# 使用stdio传输启动（默认）
myai

# 使用HTTP传输启动
myai server --transport http

# 处理记忆命令
myai remember "我更喜欢暗模式"

# 跨平台同步
myai sync

选项2：从源码运行

克隆并构建源码：

git clone https://github.com/Jktfe/myaimemory-mcp.git
cd myaimemory-mcp
npm install
npm run build
npm start  # 使用stdio传输启动
# 或
npm run start:http  # 使用HTTP传输启动

选项3：Docker

使用Docker构建和运行：

docker build -t myai-memory-sync .
docker run -v myai-memory:/app/data -p 3000:3000 myai-memory-sync

🔌 MCP配置

Claude桌面配置

在您的claude_desktop_config.json中添加以下内容：

{
  "mcpServers": {
    "myai-memory-sync": {
      "command": "npx",
      "args": [
        "-y",
        "myai"
      ],
      "env": {
        "TEMPLATE_PATH": "/path/to/custom/template.md",
        "ENABLE_ANTHROPIC": "true",
        "ANTHROPIC_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude.ai与Smithery

访问Smithery.ai
添加myAI Memory Sync MCP：
```
@Jktfe/myaimemory-mcp
```
在Smithery设置中配置您的API密钥

Windsurf集成

在Windsurf中，向您的.codeium/config.json添加以下内容：

{
  "mcp": {
    "servers": {
      "myai-memory-sync": {
        "command": "npx",
        3. "args": [
            "-y",
            "myai"
          ]
        }
      }
    }
  }

HTTP服务器模式

对于HTTP传输而不是stdio：

# 使用npm脚本：
npm run start:http

# 使用统一的CLI：
myai server --transport http

# 使用带有自定义端口的shell脚本：
./start-server.sh --http --port=8080

# 使用环境变量：
PORT=8080 npm run start:http

环境变量

创建一个.env文件，包含以下选项：

# 基本配置
DEBUG=true                      # 启用调试日志
TEMPLATE_PATH=./data/template.md  # 自定义模板位置
PORT=3000                       # HTTP传输端口（默认：3000）
USE_DIRECT=true                 # 使用直接实现（无SDK）

# 平台特定路径
WINDSURF_MEMORY_PATH=~/.codeium/windsurf/memories/global_rules.md
CLAUDE_PROJECTS_PATH=~/CascadeProjects

# 性能优化
ENABLE_ANTHROPIC=true           # 启用Anthropic API集成
ANTHROPIC_API_KEY=your-api-key  # 您的Anthropic API密钥
ENABLE_PROMPT_CACHE=true        # 启用提示缓存系统
CACHE_TTL=300000                # 缓存TTL（毫秒，5分钟）

# Claude网页同步（可选）
CLAUDE_WEB_SYNC_ENABLED=false   # 启用Claude.ai网页同步
CLAUDE_WEB_EMAIL=you@email.com  # 您的Claude.ai电子邮件
CLAUDE_WEB_HEADLESS=true        # 以无头模式运行浏览器

🧙‍♂️ 系统提示集成

为了获得最佳效果，请将以下内容添加到您的Claude系统提示中：

记忆整合说明：
当您收到以“使用myAI Memory来”开头的命令时，您应该：

1. 将剩余的指令视为记忆管理命令
2. 尝试根据内容确定适当的更新部分
3. 使用myAI Memory Sync MCP更新您的记忆
4. 用简短的确认语句确认更新

例如：
“使用myAI Memory来记住我更喜欢暗模式”
→ 更新偏好部分，添加暗模式偏好

当被询问关于偏好或个人信息的问题时，首先通过myAI Memory Sync MCP检查您的记忆。始终引用记忆中的信息，而不是做出假设。

✨ 功能

🔄 跨平台同步：更新一次，同步所有地方
⚡ 闪电般快速回忆：缓存系统，性能提升高达2000倍
🗣️ 自然语言接口：只需自然对话即可更新您的偏好
🧩 多个个人资料配置文件：轻松切换不同的预设
🔐 注重安全：本地存储，.gitignore保护
🛠️ 开发者友好：完整的TypeScript实现，全面的API

🧩 核心架构

myAI Memory Sync采用模块化架构，包含以下关键组件：

模板解析器：在结构化记忆对象和markdown之间进行双向转换
模板存储：持久存储，内存和文件系统缓存
平台同步器：为每个目标平台实现PlatformSyncer接口
自然语言处理器：从自然语言记忆命令中提取结构化数据
记忆缓存服务：通过多级缓存策略优化性能

🔍 详细功能

跨平台同步

ClaudeCodeSyncer：更新所有仓库中的CLAUDE.md文件
WindsurfSyncer：管理Windsurf环境中的global_rules.md
ClaudeWebSyncer：可选基于Puppeteer的Claude.ai网页界面同步

智能记忆管理

基于模式的提取：将自然语言转换为结构化的键值对
部分检测算法：自动确定新记忆的适当部分
记忆模板格式：基于markdown的结构，包含部分、描述和键值项
上下文保留：更新记忆部分同时保留其他模板内容

性能优化

多级缓存：在模板和部分级别上的内存缓存
基于TTL的缓存管理：可配置的缓存内容生存期
预热：模板更新后的缓存预填充
可选的Anthropic API集成：加速记忆相关查询高达2000倍

安全

本地优先架构：所有数据保留在您的设备上
.gitignore管理：自动将CLAUDE.md添加到所有仓库的.gitignore中
文件权限处理：解决权限问题以实现最大兼容性
加密存储：兼容加密文件系统

📋 记忆模板格式

该系统使用结构化的markdown格式来组织您的偏好：

# myAI Memory

# 用户信息
## 如果需要直接引用它们，请使用这些信息
-~- 名称：您的名称
-~- 地点：您的地点
-~- 喜好：阅读、远足、科技

# 通用响应风格
## 在每个响应中使用
-~- 风格：友好且简洁
-~- 使用英国英语拼写：true
-~- 当合适时使用表情符号：true

# 编码偏好
## 对应编码问题的一般偏好
-~- 我更喜欢TypeScript而不是JavaScript
-~- 显示逐步解释

🛠️ 技术实现

MemoryTemplate模式

interface MemoryTemplate {
  sections: TemplateSection[];
}

interface TemplateSection {
  title: string;
  description: string;
  items: TemplateItem[];
}

interface TemplateItem {
  key: string;
  value: string;
}

平台同步接口

interface PlatformSyncer {
  sync(templateContent: string): Promise<SyncStatus>;
}

type PlatformType = 'claude-web' | 'claude-code' | 'windsurf' | 'master';

interface SyncStatus {
  platform: PlatformType;
  success: boolean;
  message: string;
}

🔌 MCP集成API

myAI Memory Sync工具实现了模型上下文协议（MCP），包含以下函数：

函数	描述	参数
`get_template`	获取完整的记忆模板	无
`get_section`	获取特定部分	`sectionName: string`
`update_section`	更新特定部分	`sectionName: string, content: string`
`update_template`	替换整个模板	`content: string`
`list_presets`	列出可用预设	无
`load_preset`	加载特定预设	`presetName: string`
`create_preset`	创建新的预设	`presetName: string`
`sync_platforms`	跨平台同步	`platform?: string`
`list_platforms`	列出可用平台	无

自然语言接口

用户可以通过自然语言命令与系统互动：

您：使用myAI Memory记住我更喜欢TypeScript而不是JavaScript
Claude：✅已添加到您的编码偏好！我会记住您更喜欢TypeScript而不是JavaScript。

您：使用myAI Memory加载预设developer
Claude：✅已加载developer预设！我现在将使用您的开发者偏好。

🧙‍♂️ 高级用法

记忆预设

轻松切换不同的角色：

您：使用myAI Memory列出预设
Claude：可用预设：个人、工作、开发者

您：使用myAI Memory加载预设developer
Claude：✅已加载developer预设！

紧急同步

当您需要修复所有平台上的同步问题时：

# 立即同步一切
./emergency-sync.sh

命令行接口

# 查看所有可用命令
node dist/cli.js --help

# 直接处理记忆命令
node dist/cli.js --remember "记住我更喜欢暗模式"

# 启动HTTP服务器用于SSE传输
npm run start:http

# 启动stdio服务器用于MCP传输
npm run start

开发流程

# 在开发模式下运行，自动重新加载
npm run dev

# 在开发模式下运行，使用HTTP服务器
npm run dev:http

# 监视TypeScript编译
npm run build:watch

# 运行测试
npm test

# 运行特定测试
npm test -- -t "platformSync"

# 检查代码
npm run lint

# 不生成文件的情况下进行类型检查
npm run typecheck

⚡ 性能基准

我们的缓存系统提供了惊人的性能改进：

操作	无缓存	有缓存	提升
记忆查询	~2000ms	~1ms	2000倍
部分查找	~1600ms	~0.8ms	2000倍
模板解析	~120ms	~0.1ms	1200倍
平台同步	~850ms	~350ms	2.4倍

🔒 安全与隐私

我们非常重视您的隐私：

所有数据保留在您的设备上
CLAUDE.md文件自动添加到.gitignore中
除非使用可选的Anthropic API集成，否则不会将数据发送到外部服务器
与加密文件系统兼容，以实现最大安全性

🛠️ 故障排除

常见问题

CLAUDE.md未更新
- 检查文件权限：ls -la CLAUDE.md
- 尝试紧急同步：./emergency-sync.sh
- 验证平台路径在您的.env文件中
MCP连接失败
- 确保MCP服务器正在运行：ps aux | grep myai-memory
- 检查Claude桌面日志中的MCP错误
- 验证您的Claude桌面配置文件
缓存问题
- 清除缓存：node dist/cli.js --clear-cache
- 验证Anthropic API密钥是否正确设置
- 检查记忆文件完整性：node dist/cli.js --validate
自然语言命令不起作用
- 确保使用的是支持的命令模式之一（参见支持的自然语言命令部分）
- 如果Claude无法识别您的命令，请尝试另一种模式
- 若要跨所有平台同步，请使用直接脚本：node sync-memory.js

手动同步

如果您遇到自然语言命令或MCP服务器的问题：

# 直接同步