Cursor Memory MCP

Cursor Memory MCP

🧠 シンプルな MCP インターフェースを通じて、AI アシスタントが Cursor でプロジェクトのメモリファイルを作成、管理できるようにします。

Cursor Memory MCP Server は、Model Context Protocol（MCP）を通じて、AI アシスタントと Cursor のプロジェクトメモリシステムをつなぐブリッジを提供します。AI モデルが、プロジェクトの .cursor/rules/ ディレクトリにある .mdc メモリファイルを自動的に作成、管理できるようにします。

✨ 主な機能

• 🧠 メモリの記録：.cursor/rules/ ディレクトリにタスクのメモリファイルを自動作成
• 📝 構造化フォーマット：Cursor の仕様に従って適切にフォーマットされた .mdc ファイルを生成
• 🔄 コンテキストの保存：後で参照できるよう、タスクの実行コンテキストを保持
• 🌐 多言語対応：中国語および国際的なコンテンツを完全にサポート
• 💻 クロスプラットフォーム：Windows、macOS、Linux でシームレスに動作
• ⚡ MCP 標準プロトコル：Model Context Protocol を基盤とし、AI とシームレスに連携

🚀 クイックスタート

Smithery 経由でインストール

Smithery 経由で、Cursor の MCP クライアント向けに Cursor Memory MCP を自動インストールするには：

npx -y @smithery/cli install cursor-memory-mcp --client cursor

pip 経由でインストール

パフォーマンスと分離性を高めるため、uv を使ってインストールします：

# Install globally as a tool
uv tool install cursor-memory-mcp

# Update PATH to use the tool
uv tool update-shell

手順1：Cursor の設定 --> MCP --> 構成を追加（後述）

手順2：Cursor の設定 --> RULES --> ユーザールールを追加：

After task execution is completed, use `cursor memory` to track task execution records

手順3：エージェントにコーディングを手伝ってもらいます

段階的に開発を進めると、プロジェクトのルールに Cursor の操作履歴が記録されます。Cursor がその履歴を必要とするときに参照し、メモリを活用して作業を行います。

開発用にインストール

開発およびコントリビューション向け：

# Clone and set up development environment
git clone https://github.com/yourusername/cursor-memory-mcp.git
cd cursor-memory-mcp

# Create and activate virtual environment
python -m venv .venv
source .venv/bin/activate  # Linux/macOS
# or
.venv\Scripts\activate     # Windows

# Install with development dependencies
pip install -e ".[dev]"

代替方法：uv を使用（推奨）

# Install globally
uv tool install cursor-memory-mcp

# For development
git clone https://github.com/yourusername/cursor-memory-mcp.git
cd cursor-memory-mcp
uv venv
source .venv/bin/activate  # Linux/macOS
# or
.venv\Scripts\activate     # Windows
uv pip install -e ".[dev]"

🔌 MCP 連携

Cursor との連携

この構成を Cursor の MCP 設定に追加します：

{
    "mcpServers": {
        "cursor-memory-mcp": {
            "command": "uv",
            "args": [
                "tool",
                "run",
                "cursor-memory-mcp",
            ]
        }
    }
}

開発用の構成

ローカルインストールで開発する場合：

{
    "mcpServers": {
        "cursor-memory-mcp": {
            "command": "uv",
            "args": [
                "--directory",
                "path/to/cloned/cursor-memory-mcp",
                "run",
                "cursor-memory-mcp",
            ]
        }
    }
}

💡 利用可能なツール

このサーバーは、メモリ管理用の強力なツールを1つ提供します：

メモリ作成ツール

包括的なコンテキストを含むプロジェクトのメモリファイルを作成します：

result = await call_tool("create_cursor_memory", {
    "task_summary": "实现了用户认证系统，包括JWT token生成、密码加密验证和权限管理功能",
    "task_name": "user_authentication_system",
    "task_description": "用户认证和授权系统实现"
})

パラメーター：

パラメーター	型	必須	説明
task_summary	string	✅	タスク実行のコンテキストを詳しくまとめたもの
task_name	string	✅	短いタスク名（ファイル名として使用）
task_description	string	⚪	任意の詳細なタスク説明
project_path	string	✅	現在のプロジェクトの絶対パス

検証ルール：

• task_name に使用できるのは、英字、数字、アンダースコア、ハイフンのみです
• task_summary は空、または空白文字だけにできません
• 重複するファイルがある場合、ファイル名にタイムスタンプが自動で付与されます

📁 生成されるファイル形式

サーバーは、次の構造で .mdc ファイルを作成します：

---
description: "get the summary of previous step: {task_description}"
globs:
alwaysApply: false
---
{task_summary}

🤝 コントリビューション

皆さまからのあらゆる種類のコントリビューションを歓迎します！詳細はコントリビューションガイドをご覧ください。

🙏 謝辞

• Model Context Protocol - AI アシスタントとの連携を支える基盤
• Cursor - AI を活用したコードエディター

---

AI 開発コミュニティのために ❤️ を込めて作成

役に立ったら、このリポジトリに ⭐ を付けてください！