aiskillstore 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