Project Mem MCP

🚀 項目記憶 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 許可證。