Cursor10x 记忆系统

Cursor10x 记忆系统是一个基于模型上下文协议(MCP)的全面记忆系统,为Cursor提供持久化的上下文感知能力。该系统通过四种互补的记忆类型(短期记忆、长期记忆、情景记忆和语义记忆)来存储和检索项目信息,实现AI助手在开发过程中的上下文感知和持续辅助。

  • by sizzlebop
  • 更新于
在 GitHub 查看 sizzlebop/context-mcp

使用说明

产品定位

Cursor10x 记忆系统为AI助手(特别是Claude)创建了一个持久化的记忆层,使其能够保留和回忆项目开发过程中的各种信息,弥合无状态AI交互与持续开发工作流之间的差距。

核心功能

  • 四种记忆类型:

    • 短期记忆(STM):存储最近消息和活动文件
    • 长期记忆(LTM):存储永久性项目信息
    • 情景记忆:记录事件的时间序列
    • 语义记忆:基于向量嵌入的语义搜索
  • 高级特性:

    • 持久化上下文跨会话保持
    • 基于重要性的存储优先级
    • 多维记忆系统整合
    • 全面的检索能力
    • 健康监控和状态报告
    • 自动代码索引和语义搜索
    • 近似最近邻(ANN)搜索

适用场景

  • AI辅助的软件开发项目
  • 需要长期上下文保持的开发工作流
  • 复杂项目的知识管理和决策记录
  • 代码库的语义搜索和关联分析
  • 开发过程的时间线跟踪和回顾

工具列表

系统工具

  • mcp_cursor10x_initConversation:初始化对话,存储用户消息并检索上下文
  • mcp_cursor10x_endConversation:结束对话,记录里程碑和情景
  • mcp_cursor10x_checkHealth:检查系统健康状态
  • mcp_cursor10x_getMemoryStats:获取内存统计信息
  • mcp_cursor10x_getComprehensiveContext:从所有记忆子系统检索统一上下文

短期记忆工具

  • mcp_cursor10x_storeUserMessage:存储用户消息
  • mcp_cursor10x_storeAssistantMessage:存储助手消息
  • mcp_cursor10x_trackActiveFile:跟踪活动文件
  • mcp_cursor10x_getRecentMessages:获取最近消息
  • mcp_cursor10x_getActiveFiles:获取活动文件

长期记忆工具

  • mcp_cursor10x_storeMilestone:存储项目里程碑
  • mcp_cursor10x_storeDecision:存储项目决策
  • mcp_cursor10x_storeRequirement:存储项目需求

情景记忆工具

  • mcp_cursor10x_recordEpisode:记录情景事件
  • mcp_cursor10x_getRecentEpisodes:获取最近情景

向量记忆工具

  • mcp_cursor10x_manageVector:管理向量嵌入(存储/搜索/更新/删除)

安装教程

前置依赖

  • Node.js 18或更高版本
  • npm或yarn包管理器
  • Turso数据库账户

安装步骤

  1. 配置Turso数据库:
# 安装Turso CLI
curl -sSfL https://get.turso.tech/install.sh | bash

# 登录Turso
turso auth login

# 创建数据库
turso db create cursor10x-mcp

# 获取数据库URL和token
turso db show cursor10x-mcp --url
turso db tokens create cursor10x-mcp
  1. 配置Cursor MCP: 在项目目录的.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"
      }
    }
  }
}

调试方式

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