Cursor10x

---

概要

Cursor10x Memory System は AI アシスタント（特に Claude）向けの永続的なメモリレイヤーを作成し、次の情報を保持して呼び出せるようにします。

• 最近のメッセージと会話履歴
• 現在作業中のアクティブなファイル
• 重要なプロジェクトの節目と決定事項
• 技術的な要件と仕様
• アクションとイベントの時系列（エピソード）
• コードベースのコードスニペットと構造
• ベクトル埋め込みに基づく意味的に類似したコンテンツ
• 意味的類似性による関連コードの断片
• 関数と変数の関係を含むファイル構造

このメモリシステムは、ステートレスな AI とのやり取りと継続的な開発ワークフローの間の隔たりを埋め、より生産的でコンテキストを認識した支援を可能にします。

システムアーキテクチャ

メモリシステムは、次の 4 つの主要コンポーネントで構成されています。

1. MCP サーバー：Model Context Protocol を実装してツールを登録し、リクエストを処理します
2. メモリデータベース：Turso データベースを使用し、セッションをまたいだ永続ストレージを提供します
3. メモリサブシステム：メモリを目的別の専用システムに整理します
4. ベクトル埋め込み：テキストとコードを数値表現に変換し、意味検索を可能にします

メモリの種類

このシステムには、相互に補完する4種類のメモリが実装されています。

1. 短期メモリ（STM）

   • 最近のメッセージとアクティブなファイルを保存します
   • 現在のやり取りにすぐに使えるコンテキストを提供します
   • 新しさと重要度に基づいて自動的に優先順位を付けます

2. 長期メモリ（LTM）

   • マイルストーンや決定事項など、プロジェクトの恒久的な情報を保存します
   • アーキテクチャや設計のコンテキストを維持します
   • 重要度の高い情報を無期限に保持します

3. エピソード記憶

   • 出来事を時系列で記録します
   • アクション間の因果関係を維持します
   • プロジェクト履歴の時間的なコンテキストを提供します

4. 意味記憶

   • メッセージ、ファイル、コードスニペットのベクトル埋め込みを保存します
   • 意味的な類似性に基づいてコンテンツを取得できます
   • コンテキストに応じた取得のため、コード構造を自動的にインデックス化します
   • コードコンポーネント間の関係を追跡します
   • コードベース全体を対象に、類似性に基づく検索を提供します

機能

• 永続的なコンテキスト：複数のセッションを通じて、会話とプロジェクトのコンテキストを維持します
• 重要度に基づく保存：設定可能な重要度レベルに基づいて、情報に優先順位を付けます
• 多次元メモリ：短期、長期、エピソード、意味記憶の各システムを組み合わせます
• 包括的な検索：すべてのメモリサブシステムから統合されたコンテキストを提供します
• ヘルスモニタリング：診断機能とステータスレポートを標準搭載しています
• バナー生成：会話の開始時に、情報を伝えるコンテキストバナーを生成します
• データベースへの永続化：すべてのメモリデータをTursoデータベースに保存し、スキーマを自動作成します
• ベクトル埋め込み：テキストとコードを類似性検索用の数値表現に変換します
• 高度なベクトルストレージ：TursoのF32_BLOBとベクトル関数を利用し、埋め込みを効率的に保存します
• ANN検索：高速な類似性マッチングを実現する近似最近傍検索に対応しています
• コードインデックス作成：コード構造（関数、クラス、変数）を自動的に検出してインデックス化します
• 意味検索：完全一致するテキストではなく、意味に基づいて関連コンテンツを検索します
• 関連度スコアリング：現在のクエリとの関連度に基づいて、コンテキスト項目を順位付けします
• コード構造の検出：複数の言語にわたってコードコンポーネントを識別し、抽出します
• 埋め込みの自動生成：インデックス化されたコンテンツのベクトル埋め込みを自動的に生成します
• 相互参照検索：異なるファイルやコンポーネントにある関連コードを検索します

インストール

前提条件

• Node.js 18以降
• npmまたはyarnのパッケージマネージャー
• Tursoデータベースアカウント

セットアップ手順

1. Tursoデータベースを設定します：

# Install Turso CLI
curl -sSfL https://get.turso.tech/install.sh | bash

# Login to Turso
turso auth login

# Create a database
turso db create cursor10x-mcp

# Get database URL and token
turso db show cursor10x-mcp --url
turso db tokens create cursor10x-mcp

または、Tursoにアクセスしてサインアップし、データベースを作成して必要な認証情報を取得できます。無料プランで、プロジェクトのメモリには十分対応できます。

2. Cursor MCPを設定します：

プロジェクトディレクトリにある.cursor/mcp.jsonを更新し、データベースのURLとTursoの認証トークンを設定します。

{
  "mcpServers": {
    "cursor10x-mcp": {
      "command": "npx",
      "args": ["cursor10x-mcp"],
      "enabled": true,
      "env": {
        "TURSO_DATABASE_URL": "your-turso-database-url",
        "TURSO_AUTH_TOKEN": "your-turso-auth-token"
      }
    }
  }
}

ツールドキュメント

システムツール

mcp_cursor10x_initConversation

ユーザーメッセージを保存し、バナーを生成して、コンテキストを取得することで、1回の操作で会話を初期化します。この統合ツールを使うと、各会話の開始時にgenerateBanner、getComprehensiveContext、storeUserMessageを個別に呼び出す必要がなくなります。

パラメーター：

• content（文字列、必須）：ユーザーメッセージの内容
• importance（文字列、任意）：重要度（"low"、"medium"、"high"、"critical"）。デフォルトは"low"です
• metadata（オブジェクト、任意）：メッセージの追加メタデータ

戻り値：

• 2つのセクションを含むオブジェクト：
  • display：ユーザーに表示するバナーが含まれます
  • internal：エージェントが使用する包括的なコンテキストが含まれます

例：

// Initialize a conversation
const result = await mcp_cursor10x_initConversation({
  content: "I need to implement a login system for my app",
  importance: "medium",
});
// Result: {
//   "status": "ok",
//   "display": {
//     "banner": {
//       "status": "ok",
//       "memory_system": "active",
//       "mode": "turso",
//       "message_count": 42,
//       "active_files_count": 3,
//       "last_accessed": "4/15/2023, 2:30:45 PM"
//     }
//   },
//   "internal": {
//     "context": { ... comprehensive context data ... },
//     "messageStored": true,
//     "timestamp": 1681567845123
//   }
// }

mcp_cursor10x_endConversation

1 回の呼び出しで複数の操作を組み合わせ、会話を終了します。アシスタントの最終メッセージを保存し、達成した内容のマイルストーンを記録して、エピソード記憶にエピソードを記録します。この統合ツールを使うことで、各会話の終了時に storeAssistantMessage、storeMilestone、recordEpisode を個別に呼び出す必要がなくなります。

パラメーター：

• content（string、必須）：アシスタントの最終メッセージの内容
• milestone_title（string、必須）：記録するマイルストーンのタイトル
• milestone_description（string、必須）：達成した内容の説明
• importance（string、任意）：重要度（"low"、"medium"、"high"、"critical"）。デフォルトは "medium" です
• metadata（object、任意）：すべての記録に追加するメタデータ

戻り値：

• 各操作のステータスと結果を含むオブジェクト

例：

// End a conversation with finalization steps
const result = await mcp_cursor10x_endConversation({
  content:
    "I've implemented the authentication system with JWT tokens as requested",
  milestone_title: "Authentication Implementation",
  milestone_description:
    "Implemented secure JWT-based authentication with refresh tokens",
  importance: "high",
});
// Result: {
//   "status": "ok",
//   "results": {
//     "assistantMessage": {
//       "stored": true,
//       "timestamp": 1681568500123
//     },
//     "milestone": {
//       "title": "Authentication Implementation",
//       "stored": true,
//       "timestamp": 1681568500123
//     },
//     "episode": {
//       "action": "completion",
//       "stored": true,
//       "timestamp": 1681568500123
//     }
//   }
// }

mcp_cursor10x_checkHealth

メモリシステムの状態とデータベース接続を確認します。

パラメーター：

• 必須項目なし

戻り値：

• ヘルスステータスと診断情報を含むオブジェクト

例：

// Check memory system health
const health = await mcp_cursor10x_checkHealth({});
// Result: {
//   "status": "ok",
//   "mode": "turso",
//   "message_count": 42,
//   "active_files_count": 3,
//   "current_directory": "/users/project",
//   "timestamp": "2023-04-15T14:30:45.123Z"
// }

mcp_cursor10x_getMemoryStats

メモリシステムの詳細な統計情報を取得します。

パラメーター：

• 必須項目なし

戻り値：

• メモリに関する包括的な統計情報を含むオブジェクト

例：

// Get memory statistics
const stats = await mcp_cursor10x_getMemoryStats({});
// Result: {
//   "status": "ok",
//   "stats": {
//     "message_count": 42,
//     "active_file_count": 3,
//     "milestone_count": 7,
//     "decision_count": 12,
//     "requirement_count": 15,
//     "episode_count": 87,
//     "oldest_memory": "2023-03-10T09:15:30.284Z",
//     "newest_memory": "2023-04-15T14:30:45.123Z"
//   }
// }

mcp_cursor10x_getComprehensiveContext

短期記憶、長期記憶、エピソード記憶を組み合わせ、すべてのメモリサブシステムから統合されたコンテキストを取得します。

パラメーター：

• 必須項目なし

戻り値：

• すべてのメモリシステムから統合したコンテキストを含むオブジェクト

例：

// Get comprehensive context
const context = await mcp_cursor10x_getComprehensiveContext({});
// Result: {
//   "status": "ok",
//   "context": {
//     "shortTerm": {
//       "recentMessages": [...],
//       "activeFiles": [...]
//     },
//     "longTerm": {
//       "milestones": [...],
//       "decisions": [...],
//       "requirements": [...]
//     },
//     "episodic": {
//       "recentEpisodes": [...]
//     },
//     "system": {
//       "healthy": true,
//       "timestamp": "2023-04-15T14:30:45.123Z"
//     }
//   }
// }

短期記憶ツール

mcp_cursor10x_storeUserMessage

ユーザーメッセージを短期記憶システムに保存します。

パラメーター：

• content（string、必須）：メッセージの内容
• importance（string、任意）：重要度（"low"、"medium"、"high"、"critical"）。デフォルトは "low" です
• metadata（object、任意）：メッセージに追加するメタデータ

戻り値：

• ステータスとタイムスタンプを含むオブジェクト

例：

// Store a user message
const result = await mcp_cursor10x_storeUserMessage({
  content: "We need to implement authentication for our API",
  importance: "high",
  metadata: {
    topic: "authentication",
    priority: 1,
  },
});
// Result: {
//   "status": "ok",
//   "timestamp": 1681567845123
// }

mcp_cursor10x_storeAssistantMessage

アシスタントのメッセージを短期記憶システムに保存します。

パラメーター：

• content（string、必須）：メッセージの内容
• importance（string、任意）：重要度（"low"、"medium"、"high"、"critical"）。デフォルトは "low" です
• metadata（object、任意）：メッセージに追加するメタデータ

戻り値：

• ステータスとタイムスタンプを含むオブジェクト

例：

// Store an assistant message
const result = await mcp_cursor10x_storeAssistantMessage({
  content: "I recommend implementing JWT authentication with refresh tokens",
  importance: "medium",
  metadata: {
    topic: "authentication",
    contains_recommendation: true,
  },
});
// Result: {
//   "status": "ok",
//   "timestamp": 1681567870456
// }

mcp_cursor10x_trackActiveFile

ユーザーがアクセスまたは変更しているアクティブなファイルを追跡します。

パラメーター：

• filename（string、必須）：追跡するファイルのパス
• action（string、必須）：ファイルに対して実行した操作（open、edit、close など）
• metadata（object、任意）：追跡イベントに追加するメタデータ

戻り値：

• ステータス、ファイル名、操作、タイムスタンプを含むオブジェクト

例：

// Track an active file
const result = await mcp_cursor10x_trackActiveFile({
  filename: "src/auth/jwt.js",
  action: "edit",
  metadata: {
    changes: "Added refresh token functionality",
  },
});
// Result: {
//   "status": "ok",
//   "filename": "src/auth/jwt.js",
//   "action": "edit",
//   "timestamp": 1681567900789
// }

mcp_cursor10x_getRecentMessages

短期記憶から最近のメッセージを取得します。

パラメーター：

• limit（number、任意）：取得するメッセージの最大数。デフォルトは 10 です
• importance（string、任意）：重要度で絞り込みます

戻り値：

• ステータスとメッセージの配列を含むオブジェクト

例：

// Get recent high importance messages
const messages = await mcp_cursor10x_getRecentMessages({
  limit: 5,
  importance: "high",
});
// Result: {
//   "status": "ok",
//   "messages": [
//     {
//       "id": 42,
//       "role": "user",
//       "content": "We need to implement authentication for our API",
//       "created_at": "2023-04-15T14:30:45.123Z",
//       "importance": "high",
//       "metadata": {"topic": "authentication", "priority": 1}
//     },
//     ...
//   ]
// }

mcp_cursor10x_getActiveFiles

短期記憶からアクティブなファイルを取得します。

パラメーター：

• limit（number、任意）：取得するファイルの最大数。デフォルトは 10 です

戻り値：

• ステータスとアクティブなファイルの配列を含むオブジェクト

例：

// Get recent active files
const files = await mcp_cursor10x_getActiveFiles({
  limit: 3,
});
// Result: {
//   "status": "ok",
//   "files": [
//     {
//       "id": 15,
//       "filename": "src/auth/jwt.js",
//       "last_accessed": "2023-04-15T14:30:45.123Z",
//       "metadata": {"changes": "Added refresh token functionality"}
//     },
//     ...
//   ]
// }

長期記憶ツール

mcp_cursor10x_storeMilestone

プロジェクトのマイルストーンを長期メモリに保存します。

パラメーター：

• title（string、必須）：マイルストーンのタイトル
• description（string、必須）：マイルストーンの説明
• importance（string、任意）：重要度。デフォルトは「medium」です
• metadata（object、任意）：マイルストーンに関する追加のメタデータ

戻り値：

• ステータス、タイトル、タイムスタンプを含むオブジェクト

例：

// Store a project milestone
const result = await mcp_cursor10x_storeMilestone({
  title: "Authentication System Implementation",
  description:
    "Implemented JWT authentication with refresh tokens and proper error handling",
  importance: "high",
  metadata: {
    version: "1.0.0",
    files_affected: ["src/auth/jwt.js", "src/middleware/auth.js"],
  },
});
// Result: {
//   "status": "ok",
//   "title": "Authentication System Implementation",
//   "timestamp": 1681568000123
// }

mcp_cursor10x_storeDecision

プロジェクトの決定事項を長期メモリに保存します。

パラメーター：

• title（string、必須）：決定事項のタイトル
• content（string、必須）：決定事項の内容
• reasoning（string、任意）：決定に至った理由
• importance（string、任意）：重要度。デフォルトは「medium」です
• metadata（object、任意）：決定事項に関する追加のメタデータ

戻り値：

• ステータス、タイトル、タイムスタンプを含むオブジェクト

例：

// Store a project decision
const result = await mcp_cursor10x_storeDecision({
  title: "JWT for Authentication",
  content: "Use JWT tokens for API authentication with refresh token rotation",
  reasoning:
    "JWTs provide stateless authentication with good security and performance characteristics",
  importance: "high",
  metadata: {
    alternatives_considered: ["Session-based auth", "OAuth2"],
    decision_date: "2023-04-15",
  },
});
// Result: {
//   "status": "ok",
//   "title": "JWT for Authentication",
//   "timestamp": 1681568100456
// }

mcp_cursor10x_storeRequirement

プロジェクトの要件を長期メモリに保存します。

パラメーター：

• title（string、必須）：要件のタイトル
• content（string、必須）：要件の内容
• importance（string、任意）：重要度。デフォルトは「medium」です
• metadata（object、任意）：要件に関する追加のメタデータ

戻り値：

• ステータス、タイトル、タイムスタンプを含むオブジェクト

例：

// Store a project requirement
const result = await mcp_cursor10x_storeRequirement({
  title: "Secure Authentication",
  content:
    "System must implement secure authentication with password hashing, rate limiting, and token rotation",
  importance: "critical",
  metadata: {
    source: "security audit",
    compliance: ["OWASP Top 10", "GDPR"],
  },
});
// Result: {
//   "status": "ok",
//   "title": "Secure Authentication",
//   "timestamp": 1681568200789
// }

エピソード記憶ツール

mcp_cursor10x_recordEpisode

エピソード（アクション）をエピソード記憶に記録します。

パラメーター：

• actor（string、必須）：アクションを実行した主体（user、assistant、system）
• action（string、必須）：実行したアクションの種類
• content（string、必須）：アクションの内容または詳細
• importance（string、任意）：重要度。デフォルトは「low」です
• context（string、任意）：エピソードのコンテキスト

戻り値：

• ステータス、主体、アクション、タイムスタンプを含むオブジェクト

例：

// Record an episode
const result = await mcp_cursor10x_recordEpisode({
  actor: "assistant",
  action: "implementation",
  content: "Created JWT authentication middleware with token verification",
  importance: "medium",
  context: "authentication",
});
// Result: {
//   "status": "ok",
//   "actor": "assistant",
//   "action": "implementation",
//   "timestamp": 1681568300123
// }

mcp_cursor10x_getRecentEpisodes

エピソード記憶から最近のエピソードを取得します。

パラメーター：

• limit（number、任意）：取得するエピソードの最大数。デフォルトは10です
• context（string、任意）：コンテキストで絞り込みます

戻り値：

• ステータスとエピソードの配列を含むオブジェクト

例：

// Get recent episodes in the authentication context
const episodes = await mcp_cursor10x_getRecentEpisodes({
  limit: 5,
  context: "authentication",
});
// Result: {
//   "status": "ok",
//   "episodes": [
//     {
//       "id": 87,
//       "actor": "assistant",
//       "action": "implementation",
//       "content": "Created JWT authentication middleware with token verification",
//       "timestamp": "2023-04-15T14:45:00.123Z",
//       "importance": "medium",
//       "context": "authentication"
//     },
//     ...
//   ]
// }

ベクトルベースのメモリツール

mcp_cursor10x_manageVector

保存、検索、更新、削除の操作でベクトル埋め込みを管理する統合ツールです。

パラメーター：

• operation（string、必須）：実行する操作（"store"、"search"、"update"、"delete"）
• contentId（number、任意）：このベクトルが表すコンテンツのID（store、update、deleteで使用）
• contentType（string、任意）：コンテンツの種類（"message"、"file"、"snippet"など）
• vector（array、任意）：数値の配列としてのベクトルデータ（store、updateで使用）、またはクエリベクトル（searchで使用）
• vectorId（number、任意）：更新または削除するベクトルのID
• limit（number、任意）：検索操作で返す結果の最大数。デフォルトは10です
• threshold（number、任意）：検索操作の類似度しきい値。デフォルトは0.7です
• metadata（object、任意）：ベクトルに関する追加情報

戻り値：

• ステータスと操作結果を含むオブジェクト

例：

// Store a vector embedding
const result = await mcp_cursor10x_manageVector({
  operation: "store",
  contentId: 42,
  contentType: "message",
  vector: [0.1, 0.2, 0.3, ...], // 128-dimensional vector
  metadata: {
    topic: "authentication",
    language: "en"
  }
});
// Result: {
//   "status": "ok",
//   "operation": "store",
//   "vectorId": 15,
//   "timestamp": 1681570000123
// }

// Search for similar vectors
const searchResult = await mcp_cursor10x_manageVector({
  operation: "search",
  vector: [0.1, 0.2, 0.3, ...], // query vector
  contentType: "snippet", // optional filter
  limit: 5,
  threshold: 0.8
});
// Result: {
//   "status": "ok",
//   "operation": "search",
//   "results": [
//     {
//       "vectorId": 10,
//       "contentId": 30,
//       "contentType": "snippet",
//       "similarity": 0.92,
//       "metadata": { ... }
//     },
//     ...
//   ]
// }

データベーススキーマ

メモリシステムは、以下のデータベーステーブルを自動的に作成し、管理します。

• messages：ユーザーとアシスタントのメッセージを保存します

  • id：一意の識別子
  • timestamp：作成日時
  • role：メッセージの役割（user/assistant）
  • content：メッセージの内容
  • importance：重要度
  • archived：メッセージがアーカイブされているかどうか

• active_files：ファイルのアクティビティを追跡します

  • id：一意の識別子
  • filename：ファイルへのパス
  • action：最後に実行されたアクション
  • last_accessed：最後にアクセスした日時

• milestones：プロジェクトのマイルストーンを記録します

  • id：一意の識別子
  • title：マイルストーンのタイトル
  • description：詳細な説明
  • timestamp：作成日時
  • importance：重要度

• decisions：プロジェクトの決定事項を保存します

  • id：一意の識別子
  • title：決定事項のタイトル
  • content：決定事項の内容
  • reasoning：決定の理由
  • timestamp：作成日時
  • importance：重要度

• requirements：プロジェクトの要件を管理します

  • id：一意の識別子
  • title：要件のタイトル
  • content：要件の内容
  • timestamp：作成日時
  • importance：重要度

• episodes：アクションとイベントを記録します

  • id：一意の識別子
  • timestamp：作成日時
  • actor：アクションを実行する主体
  • action：アクションの種類
  • content：アクションの詳細
  • importance：重要度
  • context：アクションのコンテキスト

• vectors：セマンティック検索用のベクトル埋め込みを保存します

  • id：一意の識別子
  • content_id：参照先のコンテンツの ID
  • content_type：コンテンツの種類（message、file、snippet）
  • vector：埋め込みベクトルのバイナリ表現
  • metadata：ベクトルに関する追加のメタデータ

• code_files：インデックス化されたコードファイルを追跡します

  • id：一意の識別子
  • file_path：ファイルへのパス
  • language：プログラミング言語
  • last_indexed：最後にインデックス化した日時
  • metadata：ファイルに関する追加のメタデータ

• code_snippets：抽出されたコード構造を保存します

  • id：一意の識別子
  • file_id：親ファイルへの参照
  • start_line：開始行番号
  • end_line：終了行番号
  • symbol_type：コード構造の種類（function、class、variable）
  • content：コードスニペットの内容

ワークフローの例

最適化された会話の開始

// Initialize conversation with a single tool call
// This replaces the need for three separate calls at the start of the conversation
const result = await mcp_cursor10x_initConversation({
  content: "I need help implementing authentication in my React app",
  importance: "high",
});

// Display the banner to the user
console.log("Memory System Status:", result.display.banner);

// Use the context internally (do not show to user)
const context = result.internal.context;
// Use context for more informed assistance

新しいセッションの開始（別の方法）

// Generate a memory banner at the start
mcp_cursor10x_generateBanner({});

// Get comprehensive context
mcp_cursor10x_getComprehensiveContext({});

// Store the user message
mcp_cursor10x_storeUserMessage({
  content: "I need help with authentication",
  importance: "high",
});

ユーザーアクティビティの追跡

// Track an active file
await mcp_cursor10x_trackActiveFile({
  filename: "src/auth/jwt.js",
  action: "edit",
});

トラブルシューティング

よくある問題

1. データベース接続の問題

   • Turso データベースの URL と認証トークンが正しいことを確認します
   • Turso サービスへのネットワーク接続を確認します
   • ファイアウォールの設定で接続が許可されていることを確認します

2. データが見つからない

   • データが適切な重要度で保存されたことを確認します
   • 取得クエリのパラメーター（limit、filters）を確認します
   • mcp_cursor10x_checkHealth() でデータベースの状態を確認します

3. パフォーマンスの問題

   • mcp_cursor10x_getMemoryStats() でメモリ統計を確認します
   • データベースが大きくなりすぎた場合は、古いデータのアーカイブを検討します
   • より具体的なフィルターを使用して取得を最適化します

診断手順

1. システムの状態を確認します：

   const health = await mcp_cursor10x_checkHealth({});
   console.log("System Health:", health);
   

2. メモリ統計を確認します：

   const stats = await mcp_cursor10x_getMemoryStats({});
   console.log("Memory Stats:", stats);
   

3. ステータスバナーを生成します：

   const banner = await mcp_cursor10x_generateBanner({});
   console.log("Memory Banner:", banner);
   

重要度レベル

メモリに項目を保存する際は、適切な重要度レベルを使用してください。

• low：一般的な情報、定型的な操作、日常的な会話
• medium：役立つコンテキスト、標準的な作業項目、通常の機能
• high：重要な決定事項、主要な機能、重要なアーキテクチャ要素
• critical：中核となるアーキテクチャ、セキュリティ上の懸念、データ整合性の問題

ライセンス

MIT