🚀 项目记忆 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: 指定允许访问的目录，可以多次使用以指定多个目录。
💻 使用示例
基础用法
工具
- 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 <新内容>
高级用法
示例工作流程
- 开始与LLM关于项目的对话
- LLM使用
get_project_memory检索项目信息 - 在整个对话中，LLM使用
update_project_memory持久化新的信息 - 如果更新失败，LLM可以改用
set_project_memory
Claude Desktop
若你使用Claude Desktop，建议使用项目功能。 编辑项目说明：
- 添加类似“项目的路径为<项目路径>”的行
- 如果不希望总是使用记忆，可以添加类似“记忆不是可选的”的行
📚 详细文档
安全注意事项
- 内存文件中不应包含敏感信息
- 项目路径会经过允许目录的验证
- 所有文件操作均限制在允许目录内
依赖项
- fastmcp（>=2.2.0，<3.0.0）
📄 许可证
本项目采用MIT许可证。