| name | cursor-mem |
| description | Accesses the claude-mem MCP server from Cursor to search session history and record observations. Triggers: memory search, claude-mem, past decisions, record this. Do NOT load for: normal coding, temporary notes, or implementation work. |
| allowed-tools | ["Bash","Read","mcp__claude-mem__*"] |
| argument-hint | [search|record] [query] |
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_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 を呼び出し（auto mode により自動有効化）
→ クエリ: "認証 JWT Supabase 選定理由"
→ 過去の決定記録（decisions）を取得
v2.1.7+: MCP auto mode がデフォルト有効のため、MCPSearch による事前検索は不要です。
気付きの記録
ユーザー: 「この実装パターンを記録しておいて」
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（実装役）: 過去の判断を参照しながら実装
- 双方向検索: どちらからでも過去の記録を検索可能
🔄 Claude Code 2.1.7+ 対応
MCP tool search の auto mode がデフォルト有効になりました。
変更点:
- MCPSearch による明示的なツール検索は不要
- MCP ツールは直接呼び出し可能
- 初回呼び出し時に自動的にツールが有効化される
互換性:
- Claude Code 2.1.6 以前: MCPSearch を先に実行
- Claude Code 2.1.7+: 直接呼び出し可能
⚠️ 注意事項
パフォーマンス
- 初回検索時はワーカー起動に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
📚 参考資料
