Cursor10x 记忆系统

使用模型上下文协议 (MCP) 的 Cursor 综合内存系统。

🚀宣布推出 CURSOR10X 系统🚀

利用人工智能驱动的自主系统转变您的开发流程

🔥 Cursor10x 记忆系统现在是完整 Cursor10x 平台的一部分！ 🔥

在GitHub上探索完整的自主开发生态系统，其特点包括：

• 📋 任务管理系统- 引导逐步完成任务
• 🔄 自主记忆- 上下文感知人工智能，可以记住你的整个项目
• 📊 项目蓝图- 根据您的规范创建的完整技术架构
• 📁 文件/文件夹架构- 使用最佳实践优化项目结构
• 📘 实施指南- 所有文件和组件的综合文档
• 📝 详细任务- 从项目启动到完成的完整工作流程

生成完整的项目蓝图，包括文件架构、实施指南和完整的任务序列以及已实施的整个 Cursor10x 系统！

概述

Cursor10x 记忆系统为人工智能助手（特别是 Claude）创建了一个持久记忆层，使它们能够保留和回忆：

• 最近的消息和对话历史记录
• 当前正在处理的活动文件
• 重要的项目里程碑和决策
• 技术要求和规范
• 按时间顺序排列的动作和事件（情节）

该记忆系统弥合了无状态人工智能交互和持续开发工作流程之间的差距，从而提供了更高效、更具情境感知的帮助。

系统架构

记忆系统建立在三个核心组件之上：

1. MCP 服务器：实现模型上下文协议来注册工具和处理请求
2. 内存数据库：使用 Turso 数据库进行跨会话的持久存储
3. 内存子系统：将内存组织成具有不同用途的专用系统

内存类型

该系统实现了三种互补的内存类型：

1. 短期记忆（STM）
   • 存储最新消息和活动文件
   • 为当前交互提供即时背景
   • 根据新近度和重要性自动确定优先级
2. 长期记忆（LTM）
   • 存储永久项目信息，如里程碑和决策
   • 保持建筑和设计背景
   • 无限期地保存重要信息
3. 情景记忆
   • 按时间顺序记录事件
   • 维持动作之间的因果关系
   • 提供项目历史的时间背景

特征

• 持久上下文：在多个会话中维护对话和项目上下文
• 基于重要性的存储：根据可配置的重要性级别对信息进行优先排序
• 多维记忆：结合短期、长期和情景记忆系统
• 综合检索：提供来自所有内存子系统的统一上下文
• 健康监测：包括内置诊断和状态报告
• 横幅生成：创建用于对话开始的信息上下文横幅
• 数据库持久性：将所有内存数据存储在 Turso 数据库中，并自动创建模式

工具文档

系统工具

mcp_cursor10x_generateBanner

生成带有内存系统统计信息和状态信息的横幅。

参数：

• 无需

返回：

• 具有内存系统状态和统计信息的对象

例子：

mcp_cursor10x_initConversation

通过一次性操作存储用户消息、生成横幅并检索上下文来初始化对话。此统一工具无需在每个对话开始时分别调用 generateBanner、getComprehensiveContext 和 storeUserMessage。

参数：

• content （字符串，必需）：用户消息的内容
• importance （字符串，可选）：重要性级别（“低”，“中”，“高”，“关键”），默认为“低”
• metadata （对象，可选）：消息的附加元数据

返回：

• 具有两个部分的对象：
  • display ：包含要向用户显示的横幅
  • internal ：包含代理使用的综合上下文

例子：

mcp_cursor10x_endConversation

通过在一次调用中组合多个操作来结束对话：存储助手的最终消息、记录已完成任务的里程碑，以及在情景记忆中记录一个情节。此统一工具取代了每次对话结束时分别调用 storeAssistantMessage、storeMilestone 和 recordEpisode 的需要。

参数：

• content （字符串，必需）：助手的最终消息的内容
• milestone_title （字符串，必需）：要记录的里程碑的标题
• milestone_description (字符串，必需)：对已完成事项的描述
• importance （字符串，可选）：重要性级别（“低”，“中”，“高”，“关键”），默认为“中”
• metadata （对象，可选）：所有记录的附加元数据

返回：

• 具有每个操作的状态和结果的对象

例子：

mcp_cursor10x_checkHealth

检查内存系统及其数据库连接的健康状况。

参数：

• 无需

返回：

• 具有健康状态和诊断的对象

例子：

mcp_cursor10x_getMemoryStats

检索有关内存系统的详细统计信息。

参数：

• 无需

返回：

• 具有全面内存统计信息的对象

例子：

mcp_cursor10x_getComprehensiveContext

从所有记忆子系统中检索统一的上下文，结合短期、长期和情景记忆。

参数：

• 无需

返回：

• 来自所有记忆系统的具有合并上下文的对象

例子：

短期记忆工具

mcp_cursor10x_storeUserMessage

将用户消息存储在短期记忆系统中。

参数：

• content （字符串，必需）：消息的内容
• importance （字符串，可选）：重要性级别（“低”，“中”，“高”，“关键”），默认为“低”
• metadata （对象，可选）：消息的附加元数据

返回：

• 具有状态和时间戳的对象

例子：

mcp_cursor10x_storeAssistantMessage

将辅助信息存储在短期记忆系统中。

参数：

• content （字符串，必需）：消息的内容
• importance （字符串，可选）：重要性级别（“低”，“中”，“高”，“关键”），默认为“低”
• metadata （对象，可选）：消息的附加元数据

返回：

• 具有状态和时间戳的对象

例子：

mcp_cursor10x_trackActiveFile

跟踪用户正在访问或修改的活动文件。

参数：

• filename （字符串，必需）：被跟踪的文件的路径
• action （字符串，必需）：对文件执行的操作（打开、编辑、关闭等）
• metadata （对象，可选）：跟踪事件的附加元数据

返回：

• 具有状态、文件名、操作和时间戳的对象

例子：

mcp_cursor10x_getRecentMessages

从短期记忆中检索最新消息。

参数：

• limit （数字，可选）：要检索的最大消息数，默认为 10
• importance （字符串，可选）：按重要性级别过滤

返回：

• 具有状态和消息数组的对象

例子：

mcp_cursor10x_getActiveFiles

从短期记忆中检索活动文件。

参数：

• limit （数字，可选）：要检索的最大文件数，默认为 10

返回：

• 具有状态和活动文件数组的对象

例子：

长期记忆工具

mcp_cursor10x_storeMilestone

将项目里程碑存储在长期记忆中。

参数：

• title （字符串，必需）：里程碑的标题
• description （字符串，必需）：里程碑的描述
• importance （字符串，可选）：重要性级别，默认为“medium”
• metadata （对象，可选）：里程碑的附加元数据

返回：

• 具有状态、标题和时间戳的对象

例子：

mcp_cursor10x_storeDecision

将项目决策存储在长期记忆中。

参数：

• title （字符串，必需）：决策的标题
• content （字符串，必需）：决策的内容
• reasoning （字符串，可选）：决策背后的推理
• importance （字符串，可选）：重要性级别，默认为“medium”
• metadata （对象，可选）：决策的附加元数据

返回：

• 具有状态、标题和时间戳的对象

例子：

mcp_cursor10x_storeRequirement

将项目需求存储在长期记忆中。

参数：

• title （字符串，必需）：需求的标题
• content （字符串，必需）：需求的内容
• importance （字符串，可选）：重要性级别，默认为“medium”
• metadata （对象，可选）：需求的附加元数据

返回：

• 具有状态、标题和时间戳的对象

例子：

情景记忆工具

mcp_cursor10x_recordEpisode

在情景记忆中记录一个情节（动作）。

参数：

• actor （字符串，必需）：执行动作的演员（用户、助手、系统）
• action （字符串，必需）：执行的操作类型
• content （字符串，必需）：操作的内容或详细信息
• importance （字符串，可选）：重要性级别，默认为“低”
• context （字符串，可选）：该剧集的背景

返回：

• 具有状态、参与者、动作和时间戳的对象

例子：

mcp_cursor10x_getRecentEpisodes

从情景记忆中检索最近的情景。

参数：

• limit （数字，可选）：要检索的最大剧集数量，默认为 10
• context （字符串，可选）：按上下文过滤

返回：

• 具有状态和剧集数组的对象

例子：

自定义指令示例

安装

先决条件

• Node.js 18 或更高版本
• npm 或 yarn 包管理器
• 用于本地开发的 Turso 数据库帐户或 SQLite

设置Turso数据库

内存系统使用 Turso (LibSQL) 进行数据库存储。要设置 Turso 数据库：

1. 创建 Turso 帐户如果您没有帐户，请在Turso.tech上注册。
2. 安装 Turso CLI

3. 登录 Turso

4. 创建数据库

5. 获取数据库 URL
   turso db show cursor10x-mcp --url
6. 创建身份验证令牌
   turso db tokens create cursor10x-mcp

保存数据库 URL 和身份验证令牌以供配置使用。

分步安装

1. 从 npm 安装包
   npm install -g cursor10x-mcp
2. 创建 Cursor MCP 配置在您的主目录中创建或编辑.cursor/mcp.json文件：
   mkdir -p ~/.cursor touch ~/.cursor/mcp.json
   在文件中添加以下配置：
   { "mcpServers": { "cursor10x-mcp": { "command": "npx", "args": [ "cursor10x-mcp" ], "enabled": true, "env": { "TURSO_DATABASE_URL": "your-turso-database-url", "TURSO_AUTH_TOKEN": "your-turso-auth-token" } } } }
   确保使用您的实际 Turso 凭证。
3. 重启光标保存配置后，重新启动Cursor即可加载内存系统。
4. 验证安装通过让 Claude 运行mcp_cursor10x_generateBanner工具来测试安装。

对于开发人员

如果你想参与 cursor10x-mcp 开发：

1. 克隆存储库
   git clone https://github.com/your-username/cursor10x-mcp.git cd cursor10x-mcp
2. 安装依赖项

3. 使用您的 Turso 凭证创建一个 .env.local 文件
   cp .env.example .env.local # Edit .env.local with your actual credentials
4. 以开发模式运行

5. 构建并发布到 npm
   # Update package.json with your information npm run build npm publish

配置

环境变量

可以使用以下环境变量配置内存系统：

• TURSO_DATABASE_URL ：Turso 数据库连接的 URL（必需）
• TURSO_AUTH_TOKEN ：Turso 数据库访问的身份验证令牌（必需）
• MCP_LOG_LEVEL ：日志级别（“错误”、“警告”、“信息”、“调试”），默认为“信息”
• MCP_PORT ：如果使用 HTTP 传输，则 MCP 服务器的端口，默认为 3000

光标中的配置

将内存系统配置添加到您的.cursor/mcp.json文件：

请确保：

1. 将/path/to/your/cursor10x-mcp/index.js替换为 index.js 文件的实际路径
2. 将your-turso-database-url替换为您的 Turso 数据库 URL
3. 将your-turso-auth-token替换为您的 Turso 身份验证令牌
4. 如果.cursor目录尚不存在，请在主目录中创建它

您可以通过检查重新启动 Cursor 后 Claude 是否可以访问内存工具来验证配置。

数据库架构

内存系统自动创建并维护以下数据库表：

• messages ：存储用户和助手消息
  • id ：唯一标识符
  • timestamp ：创建时间戳
  • role ：消息角色（用户/助手）
  • content ：消息内容
  • importance ：重要性级别
  • archived ：邮件是否已存档
• active_files ：跟踪文件活动
  • id ：唯一标识符
  • filename ：文件路径
  • action ：最后执行的操作
  • last_accessed ：上次访问的时间戳
• milestones ：记录项目里程碑
  • id ：唯一标识符
  • title ：里程碑标题
  • description ：详细描述
  • timestamp ：创建时间戳
  • importance ：重要性级别
• decisions ：存储项目决策
  • id ：唯一标识符
  • title ：决策标题
  • content ：决策内容
  • reasoning ：决策推理
  • timestamp ：创建时间戳
  • importance ：重要性级别
• requirements ：维护项目要求
  • id ：唯一标识符
  • title ：需求标题
  • content ：需求内容
  • timestamp ：创建时间戳
  • importance ：重要性级别
• episodes ：记录行动和事件
  • id ：唯一标识符
  • timestamp ：创建时间戳
  • actor ：表演动作的演员
  • action ：动作类型
  • content ：动作细节
  • importance ：重要性级别
  • context ：动作上下文

示例工作流程

优化对话开始

开始新会话（替代方法）

追踪用户活动

故障排除

常见问题

1. 数据库连接问题
   • 验证您的 Turso 数据库 URL 和身份验证令牌是否正确
   • 检查 Turso 服务的网络连接
   • 验证防火墙设置是否允许连接
2. 缺失数据
   • 检查数据是否按适当的重要性级别存储
   • 验证检索查询参数（限制、过滤器）
   • 使用mcp_cursor10x_checkHealth()检查数据库健康状况
3. 性能问题
   • 使用mcp_cursor10x_getMemoryStats()监控内存统计信息
   • 如果数据库变得太大，请考虑归档旧数据
   • 使用更具体的过滤器优化检索

诊断步骤

1. 检查系统健康状况：
   const health = await mcp_cursor10x_checkHealth({}); console.log("System Health:", health);
2. 验证内存统计信息：
   const stats = await mcp_cursor10x_getMemoryStats({}); console.log("Memory Stats:", stats);
3. 生成状态横幅：
   const banner = await mcp_cursor10x_generateBanner({}); console.log("Memory Banner:", banner);

重要性级别

在内存中存储项目时，请使用适当的重要性级别：

• 低：一般信息、日常操作、日常对话
• 中等：有用的上下文、标准工作项目、常规功能
• 高：关键决策、主要特征、重要架构元素
• 关键：核心架构、安全问题、数据完整性问题

执照

麻省理工学院

可用工具

短期记忆工具

• mcp_cursor10x_initConversation ：通过存储用户消息、生成横幅并在一次操作中检索上下文来初始化对话
  • 参数：
    • content （必填）：用户留言内容
    • importance （可选，默认值：“低”）：重要性级别（低、中、高、关键）
    • metadata （可选）：消息的附加元数据
  • 返回：包含横幅和上下文的对象
• mcp_cursor10x_storeUserMessage ：将用户消息存储在短期记忆中
  • 参数：
    • content （必填）：邮件内容
    • importance （可选，默认值：“低”）：重要性级别（低、中、高、关键）
    • metadata （可选）：消息的附加元数据
  • 返回：存储的消息ID

系统工具

• mcp_cursor10x_endConversation ：通过存储助手的最终消息、记录里程碑以及在情景记忆中记录情节来完成对话
  • 参数：
    • content （必填）：助理最后留言的内容
    • milestone_title （必填）：完成里程碑的标题
    • milestone_description （必需）：对已完成工作的描述
    • importance （可选，默认值：“中”）：重要性级别（低、中、高、关键）
    • metadata （可选）：操作的附加元数据
  • 返回：包含每个操作的状态和结果的对象
• mcp_cursor10x_generateBanner ：生成包含内存系统统计信息和状态的横幅
  • 参数：无
  • 返回：带有内存系统信息的格式化横幅
• mcp_cursor10x_checkHealth ：检查内存系统及其数据库的健康状况
  • 参数：无
  • 返回：健康状态信息
• mcp_cursor10x_getMemoryStats ：检索有关内存系统的统计信息
  • 参数：无
  • 返回：有关消息、活动文件和其他内存组件的统计信息