项目记忆管理工具

Cursor Memory MCP 是一个基于模型上下文协议(MCP)的工具,用于在Cursor编辑器中自动创建和管理项目记忆文件,支持多语言和跨平台使用。

  • by zjmwqx
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 zjmwqx/cursor-memory-mcp

使用说明

光标存储器MCP

🧠 使AI助手能够通过简单的MCP界面在Cursor中创建和管理项目内存文件。

Cursor Memory MCP Server通过模型上下文协议(MCP)在AI助手和Cursor的项目存储系统之间提供桥梁。它允许AI模型自动创建和管理 .mdc 项目中的内存文件 .cursor/rules/ 目录。

✨ 核心功能

  • 🧠 存储器记录:在中自动创建任务内存文件 .cursor/rules/ 目录
  • 📝 结构格式:生成格式正确的 .mdc 符合Cursor规范的文件
  • 🔄 上下文保存:保留任务执行上下文以供将来参考
  • 🌐 多语言:全力支持中文和国际内容
  • 💻 交叉平台的:在Windows、macOS和Linux上无缝工作
  • ⚡ MCP标准协议:基于模型上下文协议构建,实现无缝的人工智能集成

🚀 快速开始

通过Smithery安装

通过以下方式自动为Cursor的MCP客户端安装Cursor Memory MCP 史密瑟里:

npx -y @smithery/cli install cursor-memory-mcp --client cursor

通过pip安装

使用紫外线进行安装,以获得更好的性能和隔离:

# Install globally as a tool
uv tool install cursor-memory-mcp

# Update PATH to use the tool
uv tool update-shell

步骤1。光标设置-->MCP-->添加配置(稍后参考)

步骤二游标设置-->规则-->添加用户规则:

After task execution is completed, use `cursor memory` to track task execution records

步骤三呼叫客服帮助您编码

当您逐步开发时,proj规则将记录游标操作历史,当游标需要它们时,它将引用它并使用内存完成您的工作。

安装用于开发

为了发展和贡献:

# Clone and set up development environment
git clone https://github.com/yourusername/cursor-memory-mcp.git
cd cursor-memory-mcp

# Create and activate virtual environment
python -m venv .venv
source .venv/bin/activate  # Linux/macOS
# or
.venv\Scripts\activate     # Windows

# Install with development dependencies
pip install -e ".[dev]"

替代方案:使用紫外线(推荐)

# Install globally
uv tool install cursor-memory-mcp

# For development
git clone https://github.com/yourusername/cursor-memory-mcp.git
cd cursor-memory-mcp
uv venv
source .venv/bin/activate  # Linux/macOS
# or
.venv\Scripts\activate     # Windows
uv pip install -e ".[dev]"

🔌 MCP集成

光标集成

将此配置添加到光标MCP设置中:

{
    "mcpServers": {
        "cursor-memory-mcp": {
            "command": "uv",
            "args": [
                "tool",
                "run",
                "cursor-memory-mcp",
            ]
        }
    }
}

开发配置

对于本地安装的开发:

{
    "mcpServers": {
        "cursor-memory-mcp": {
            "command": "uv",
            "args": [
                "--directory",
                "path/to/cloned/cursor-memory-mcp",
                "run",
                "cursor-memory-mcp",
            ]
        }
    }
}

💡 可用工具

服务器提供了一个强大的内存管理工具:

内存创建工具

创建具有全面上下文的项目内存文件:

result = await call_tool("create_cursor_memory", {
    "task_summary": "实现了用户认证系统,包括JWT token生成、密码加密验证和权限管理功能",
    "task_name": "user_authentication_system",
    "task_description": "用户认证和授权系统实现"
})

参数:

参数 类型 必填 说明
task_summary string ✅ 详细的任务执行上下文总结
task_name string ✅ 简短的任务名称(用作文件名)
task_description string ⚪ 可选的详细任务描述
project_path string ✅ 当前项目的绝对路径

验证规则:

  • task_name 只能包含字母、数字、下划线和连字符
  • task_summary 不能为空或仅为空白
  • 如果存在重复项,文件会自动打上时间戳

📁 生成的文件格式

服务器创建 .mdc 具有以下结构的文件:

---
description: "get the summary of previous step: {task_description}"
globs:
alwaysApply: false
---
{task_summary}

🤝 贡献

我们欢迎各种各样的贡献!请查看我们的 贡献指南 了解详情。

🙏 致谢


由以下材料制成❤️ 面向人工智能开发社区

星⭐ 如果你觉得这个仓库有用的话!