# AI

**Repository Path**: jerryzu/ai

## Basic Information

- **Project Name**: AI
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-15
- **Last Updated**: 2026-02-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# AI

#### 介绍

OpenMemory MCP 是一个本地化的AI记忆共享解决方案，支持 Claude、Cursor 等AI编程工具之间的记忆同步与共享。本项目旨在帮助开发者实现跨工具的项目上下文管理，提升AI辅助开发效率。

#### 软件架构

**核心技术栈：**
- **后端服务**：FastAPI + Python
- **前端界面**：Next.js + React
- **数据库**：PostgreSQL（结构化数据存储）
- **向量数据库**：Qdrant（记忆向量化存储与检索）
- **通信协议**：MCP（Model Context Protocol）
- **容器化**：Docker + Docker Compose

**架构特点：**
- 本地化部署，保障数据隐私安全
- 支持多客户端连接（Claude Desktop、Cursor、Windsurf等）
- 统一的记忆存储与跨工具共享机制
- 向量化检索，快速匹配相关记忆

#### 安装教程

**前提条件：**
- Docker 和 Docker Compose
- Node.js 和 pnpm
- OpenAI API Key

**详细安装步骤：**

1. **克隆代码仓库并设置OpenAI API密钥**
   ```bash
   git clone <仓库地址>
   cd <项目目录>
   # 设置OpenAI API密钥为环境变量
   export OPENAI_API_KEY="your-api-key"
   ```

2. **设置后端服务**
   ```bash
   # 复制环境文件并更新OPENAI_API_KEY和其他密钥
   cp .env.example .env
   # 编辑.env文件，填入必要的配置信息
   
   # 构建所有Docker镜像
   docker-compose build
   
   # 启动Postgres、Qdrant、FastAPI/MCP服务器
   docker-compose up -d
   ```

3. **设置前端**
   ```bash
   # 使用pnpm安装依赖
   pnpm install
   
   # 运行Next.js开发服务器
   pnpm dev
   ```

#### 使用说明

**方式一：跨工具项目开发流程**

1. **连接多个MCP客户端**
   - 在 Cursor 中安装 MCP 配置
   - 在 Claude Desktop 中安装 MCP 配置

2. **在 Claude 中定义项目需求**
   - 使用自然语言描述项目目标和关键需求
   - 让Claude将重要信息存储到记忆中

3. **在 Cursor 中进行开发**
   - Cursor 自动读取项目记忆上下文
   - 基于已有设计进行编码实现

4. **在 Windsurf 中进行调试**
   - 利用共享记忆进行问题定位
   - 保持调试上下文的一致性

5. **通过仪表板查看项目记忆**
   - 访问前端界面管理所有记忆
   - 手动创建、编辑或删除记忆条目

**方式二：个人化编码助手**

1. **存储编码偏好**
   - 记录代码风格、规范要求
   - 保存常用的代码模式

2. **创建项目基本设置**
   - 定义项目技术栈
   - 配置开发环境要求

3. **遇到错误时获取帮助**
   - 记录常见错误及解决方案
   - 快速检索历史解决记录

4. **跟踪学习进度**
   - 记录学习笔记和心得
   - 建立个人知识库

#### 高级功能与使用技巧

**记忆管理：**
- 通过仪表板可视化查看所有记忆条目
- 支持按标签、时间、类型筛选记忆
- 批量操作管理记忆内容

**手动创建记忆：**
- 在仪表板中直接添加新记忆
- 支持设置记忆标签和关联项目
- 可定义记忆的重要程度

**访问控制：**
- 配置不同客户端的访问权限
- 设置记忆的可见范围
- 管理API访问密钥

#### 常见问题与解决方案

**Q1: OpenMemory MCP服务器无法启动或连接失败**
- 检查 Docker 服务是否正常运行
- 确认端口（默认8000）未被占用
- 查看日志排查具体错误信息
- 验证 `.env` 配置文件是否正确

**Q2: 记忆没有被正确检索**
- 确认 OpenAI API Key 有效且有余额
- 检查向量数据库是否正确初始化
- 验证记忆内容是否符合向量化工求
- 尝试调整检索相似度阈值

**Q3: 如何在多台设备间共享记忆？**
- 目前版本仅支持本地存储
- 可通过备份数据库文件实现迁移
- 未来版本计划支持云端同步

#### 参与贡献

1. Fork 本仓库
2. 新建 Feat_xxx 分支
3. 提交代码
4. 新建 Pull Request

#### 特技

1. 使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md
2. Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com)
3. 你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目
4. [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目
5. Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
6. Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)