この本文は AI(Claude)が読むための原文(英語または中国語)です。日本語訳は順次追加中。

Cursor-Mem Integration Skill

CursorからClaude-memを活用するスキル。Claude CodeとCursorで同じメモリデータベースを共有し、セッション間の知識を引き継ぎます。

🎯 使用場面

検索（読み取り）

過去の意思決定を確認: 「なぜこのアーキテクチャを選んだのか？」
パターンの参照: 「以前はどのように実装したか？」
バグ修正履歴: 「同様の問題を過去に解決したか？」
技術選定の理由: 「なぜこのライブラリを使っているのか？」

記録（書き込み）

PMとしての判断をメモ: レビュー中の気付きや設計判断
パターンの記録: 再利用可能なソリューション
引き継ぎ事項: 次のセッションやチームメンバーへの情報
学習事項: トラブルシューティングで得た知見

📋 利用可能なMCPツール

Cursor上でclaude-memのMCPツールを直接利用できます：

検索系

mcp__claude-mem__search: キーワードでメモリを検索
mcp__claude-mem__timeline: 時系列で記録を取得
mcp__claude-mem__get_recent_context: 最近の文脈を取得
mcp__claude-mem__get_observation: 特定の観測を取得

書き込み系

mcp__claude-mem__create_entities: 新しいエンティティを作成
mcp__claude-mem__create_relations: エンティティ間の関連を作成
mcp__claude-mem__add_observations: 観測を追加

🔧 セットアップ

1. MCPラッパースクリプトの配置

# harness リポジトリ内に claude-mem-mcp がインストールされている前提
# 絶対パスで参照
HARNESS_PATH="/path/to/claude-code-harness"

2. Cursor MCP設定

プロジェクトルートに .cursor/mcp.json を作成：

{
  "mcpServers": {
    "claude-mem": {
      "type": "stdio",
      "command": "/absolute/path/to/claude-code-harness/scripts/claude-mem-mcp"
    }
  }
}

⚠️ 重要: command には絶対パスを指定してください。

3. Cursor再起動

設定後、Cursorを再起動してMCPサーバーを認識させます。

💡 使い方の例

詳細な使用例は examples.md を参照してください。

基本的な検索

ユーザー: 「認証方式の選定理由を確認したい」

Cursor（Composer）:
mcp__claude-mem__search を使用
→ クエリ: "認証 JWT Supabase 選定理由"
→ 過去の決定記録（decisions）を取得

気付きの記録

ユーザー: 「この実装パターンを記録しておいて」

Cursor（Composer）:
mcp__claude-mem__add_observations を使用
→ タイプ: pattern
→ タグ: source:cursor, review, best-practice
→ 内容: 実装パターンの説明

🏷️ タグ規約

Claude CodeとCursorで統一されたタグ体系を使用します：

タグ	用途
`source:cursor`	Cursorから記録された情報
`source:claude-code`	Claude Codeから記録された情報
`type:decision`	意思決定の記録
`type:pattern`	再利用可能なパターン
`type:bug`	バグ修正の記録
`type:review`	レビューでの気付き
`type:handoff`	引き継ぎ事項

🔄 Claude Code との連携

データ共有

Claude CodeとCursorは同じSQLiteデータベース（~/.claude-mem/claude-mem.db）を使用
WALモードで並行書き込みに対応
リアルタイムでデータが共有される

推奨ワークフロー

Cursor（PM役）: 設計判断やレビュー結果を記録
Claude Code（実装役）: 過去の判断を参照しながら実装
双方向検索: どちらからでも過去の記録を検索可能

⚠️ 注意事項

パフォーマンス

初回検索時はワーカー起動に2-3秒かかる場合があります
2回目以降はワーカーが常駐するため高速

セキュリティ

メモリデータベースはローカル環境にのみ保存されます
機密情報を記録する場合は注意してください

トラブルシューティング

問題: MCPツールが認識されない 解決策:

.cursor/mcp.json のパスが正しいか確認
スクリプトが実行可能か確認: chmod +x scripts/claude-mem-mcp
Cursorを再起動

問題: ワーカーが起動しない 解決策:

ヘルスチェック: curl http://127.0.0.1:37777/health
手動起動: node ~/.claude/plugins/cache/thedotmack/claude-mem/*/scripts/worker-cli.js start

cursor-mem

🎯 このSkillでできること

📦 インストール方法 (3ステップ)