🚀 项目记忆 MCP

项目记忆 MCP 是一个 MCP 服务器，用于存储和检索项目内存文件中的项目信息。借助它，AI 代理（如 Claude）能在不同对话间对项目保持持久记忆，为项目信息管理提供便利。

🚀 快速开始

Project Memory MCP 提供了一种简便的方法，可将项目信息以 Markdown 格式存储，在对话开始时检索项目信息，并使用补丁更新项目信息。内存存储在每个项目目录中的MEMORY.md文件中。

✨ 主要特性

• 将项目信息以 Markdown 格式存储。
• 在对话开始时检索项目信息。
• 使用补丁更新项目信息。

📦 安装指南

使用 uvx

这种方法使用uvx（来自uv Python 包管理器）在不永久安装的情况下运行服务器。

先决条件

若你还未安装uvx，请从uv安装。

设置 MCP 客户端（Claude Desktop、Cursor 等）

将以下配置与你的现有配置文件（例如claude_desktop_config.json）合并：

{
  "mcpServers": {
    "project-memory": {
      "command": "uvx",
      "args": [
        "project-mem-mcp",
        "--allowed-dir", "/Users/your-username/projects",
        "--allowed-dir", "/Users/your-username/Documents/code"
      ]
    }
  }
}

⚠️ 重要提示

请将/Users/your-username替换为你实际的项目和代码目录路径。

从源码安装

先决条件

• Python 3.11 或更高版本
• Pip 包管理器

克隆仓库

git clone https://github.com/your-username/project-mem-mcp.git
python -m venv venv
source venv/bin/activate
pip install -e .

设置 MCP 客户端（Claude Desktop、Cursor 等）

将以下配置与你的现有配置文件合并（例如claude_desktop_config.json）：

{
  "mcpServers": {
    "project-memory": {
      "command": "path/to/your/venv/bin/project-mem-mcp",
      "args": []
    }
  }
}

⚠️ 重要提示

请将path/to/your/venv/bin/project-mem-mcp替换为你实际的可执行文件路径。

💻 使用示例

工具

基础用法

• get_project_memory：检索项目信息

get_project_memory --project-path <项目路径>

• set_project_memory：设置项目信息

set_project_memory --project-path <项目路径> --memory-content <内存内容>

• update_project_memory：更新项目信息

update_project_memory --project-path <项目路径> --new-content <新内容>

示例工作流程

1. 开始与 LLM 关于项目的对话。
2. LLM 使用get_project_memory检索项目信息。
3. 在整个对话中，LLM 使用update_project_memory持久化新的信息。
4. 如果更新失败，LLM 可以改用set_project_memory。

Claude Desktop

若你使用 Claude Desktop，建议使用项目功能。 编辑项目说明：

• 添加类似“项目的路径为<项目路径>”的行。
• 如果不希望总是使用记忆，可以添加类似“记忆不是可选的”的行。

📚 详细文档

参数

🔧 技术细节

• 内存文件中不应包含敏感信息。
• 项目路径会经过允许目录的验证。
• 所有文件操作均限制在允许目录内。

依赖项

📄 许可证

本项目采用 MIT 许可证。