Project Mem MCP

🚀 项目记忆 MCP

项目记忆MCP是一个MCP服务器，主要用于存储和检索项目内存文件中的项目信息。借助该服务器，AI代理（如Claude）能够在不同对话之间保持对项目的持久记忆，极大提升了项目信息处理的连贯性和效率。

🚀 快速开始

项目记忆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替换为你实际的可执行文件路径。

🔧 技术细节

参数

• --allowed-dir: 指定允许访问的目录，可以多次使用以指定多个目录。

💻 使用示例

基础用法

工具

1. get_project_memory: 检索项目信息

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

2. set_project_memory: 设置项目信息

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

3. 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，建议使用项目功能。 编辑项目说明：

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

📚 详细文档

安全注意事项

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

依赖项

• fastmcp（>=2.2.0，<3.0.0）

📄 许可证

本项目采用MIT许可证。