Cursor Memory MCP

Cursor Memory MCP

🧠 通过简单的 MCP 接口，让 AI 助手能够在 Cursor 中创建和管理项目记忆文件。

Cursor Memory MCP 服务通过模型上下文协议（MCP），在 AI 助手与 Cursor 的项目记忆系统之间提供桥接。它允许 AI 模型在项目的 .cursor/rules/ 目录中自动创建和管理 .mdc 记忆文件。

✨ 核心功能

• 🧠 记忆记录：在 .cursor/rules/ 目录中自动创建任务记忆文件
• 📝 结构化格式：按照 Cursor 规范生成格式正确的 .mdc 文件
• 🔄 上下文保存：保留任务执行上下文，供将来参考
• 🌐 多语言：全面支持中文和国际化内容
• 💻 跨平台：在 Windows、macOS 和 Linux 上无缝运行
• ⚡ MCP 标准协议：基于模型上下文协议构建，可无缝集成 AI

🚀 快速开始

通过 Smithery 安装

如需通过 Smithery 自动为 Cursor 的 MCP 客户端安装 Cursor Memory MCP：

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

通过 pip 安装

使用 uv 安装，以获得更好的性能和隔离性：

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

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

步骤 1：Cursor 设置 --> MCP --> 添加配置（后文会介绍）

步骤 2：Cursor 设置 --> RULES --> 添加用户规则：

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

步骤 3：调用 Agent 帮助你编写代码

当你逐步开发时，项目规则会记录 Cursor 的操作历史；当 Cursor 需要这些记录时，就会参考它们并根据记忆完成任务。

开发环境安装

用于开发和贡献：

# 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]"

替代方案：使用 uv（推荐）

# 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 集成

Cursor 集成

将此配置添加到 Cursor 的 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}

🤝 贡献

欢迎各种形式的贡献！详情请参阅我们的贡献指南。

🙏 致谢

• 模型上下文协议 - AI 助手集成的基础
• Cursor - AI 驱动的代码编辑器

---

为 AI 开发社区倾心打造 ❤️

如果你觉得这个仓库有帮助，请点亮 ⭐！