Project Mem MCP

🚀 プロジェクトメモリMCP

このMCPサーバーは、プロジェクトのメモリファイルにプロジェクト情報を保存し、それを検索するために使用されます。これにより、ClaudeなどのAIエージェントが異なる会話間でプロジェクトに対する永続的な記憶を保持できるようになります。

🚀 クイックスタート

Project Memory MCPは、以下の簡便な方法を提供します。

• プロジェクト情報をMarkdown形式で保存する
• 会話開始時にプロジェクト情報を検索する
• パッチを使用してプロジェクト情報を更新する

メモリは、各プロジェクトディレクトリ内のMEMORY.mdファイルに保存されます。

📦 インストール

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