Cursor10x MCP

🚀 DevContext - AI開発コンテキストの次の進化

DevContextは、Cursor10xの進化形で、開発者にとってより強力で専用のコンテキストシステムです。このシステムは、AI開発を新たなレベルへと引き上げます。

🚀 クイックスタート

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データベースの設定

# Turso CLIをインストール
curl -sSfL https://get.turso.tech/install.sh | bash

# Tursoにログイン
turso auth login

# データベースを作成
turso db create cursor10x-mcp

# データベースのURLとトークンを取得
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 (string, required)：ユーザーメッセージの内容
• importance (string, optional)：重要度レベル ("low", "medium", "high", "critical")、デフォルトは "low"
• metadata (object, optional)：メッセージの追加メタデータ 戻り値：
• 2つのセクションを持つオブジェクト：
  • display：ユーザーに表示するバナーを含む
  • internal：エージェントが使用する包括的なコンテキストを含む 例：

// 会話を初期化
const result = await mcp_cursor10x_initConversation({
  content: "I need to implement a login system for my app",
  importance: "medium",
});
// 結果: {
//   "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": { ... 包括的なコンテキストデータ ... },
//     "messageStored": true,
//     "timestamp": 1681567845123
//   }
// }

mcp_cursor10x_endConversation

アシスタントの最終メッセージを保存し、達成したことのマイルストーンを記録し、エピソードメモリにエピソードを記録する1つの呼び出しで会話を終了します。この統合ツールは、各会話の終了時に個別のstoreAssistantMessage、storeMilestone、およびrecordEpisode呼び出しの必要性を排除します。 パラメータ：

• content (string, required)：アシスタントの最終メッセージの内容
• milestone_title (string, required)：記録するマイルストーンのタイトル
• milestone_description (string, required)：達成したことの説明
• importance (string, optional)：重要度レベル ("low", "medium", "high", "critical")、デフォルトは "medium"
• metadata (object, optional)：すべてのレコードの追加メタデータ 戻り値：
• 各操作のステータスと結果を持つオブジェクト 例：

// 会話を終了して終了手順を実行
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",
});
// 結果: {
//   "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

メモリシステムとそのデータベース接続のヘルスをチェックします。 パラメータ：

• 不要 戻り値：
• ヘルスステータスと診断情報を持つオブジェクト 例：

// メモリシステムのヘルスをチェック
const health = await mcp_cursor10x_checkHealth({});
// 結果: {
//   "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

メモリシステムに関する詳細な統計情報を取得します。 パラメータ：

• 不要 戻り値：
• 包括的なメモリ統計情報を持つオブジェクト 例：

// メモリ統計情報を取得
const stats = await mcp_cursor10x_getMemoryStats({});
// 結果: {
//   "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

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

• 不要 戻り値：
• すべてのメモリシステムからの統合されたコンテキストを持つオブジェクト 例：

// 包括的なコンテキストを取得
const context = await mcp_cursor10x_getComprehensiveContext({});
// 結果: {
//   "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, required)：メッセージの内容
• importance (string, optional)：重要度レベル ("low", "medium", "high", "critical")、デフォルトは "low"
• metadata (object, optional)：メッセージの追加メタデータ 戻り値：
• ステータスとタイムスタンプを持つオブジェクト 例：

// ユーザーメッセージを保存
const result = await mcp_cursor10x_storeUserMessage({
  content: "We need to implement authentication for our API",
  importance: "high",
  metadata: {
    topic: "authentication",
    priority: 1,
  },
});
// 結果: {
//   "status": "ok",
//   "timestamp": 1681567845123
// }

mcp_cursor10x_storeAssistantMessage

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

• content (string, required)：メッセージの内容
• importance (string, optional)：重要度レベル ("low", "medium", "high", "critical")、デフォルトは "low"
• metadata (object, optional)：メッセージの追加メタデータ 戻り値：
• ステータスとタイムスタンプを持つオブジェクト 例：

// アシスタントメッセージを保存
const result = await mcp_cursor10x_storeAssistantMessage({
  content: "I recommend implementing JWT authentication with refresh tokens",
  importance: "medium",
  metadata: {
    topic: "authentication",
    contains_recommendation: true,
  },
});
// 結果: {
//   "status": "ok",
//   "timestamp": 1681567870456
// }

mcp_cursor10x_trackActiveFile

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

• filename (string, required)：追跡するファイルのパス
• action (string, required)：ファイルに対して実行されるアクション (open, edit, closeなど)
• metadata (object, optional)：追跡イベントの追加メタデータ 戻り値：
• ステータス、ファイル名、アクション、およびタイムスタンプを持つオブジェクト 例：

// アクティブなファイルを追跡
const result = await mcp_cursor10x_trackActiveFile({
  filename: "src/auth/jwt.js",
  action: "edit",
  metadata: {
    changes: "Added refresh token functionality",
  },
});
// 結果: {
//   "status": "ok",
//   "filename": "src/auth/jwt.js",
//   "action": "edit",
//   "timestamp": 1681567900789
// }

mcp_cursor10x_getRecentMessages

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

• limit (number, optional)：取得する最大メッセージ数、デフォルトは10
• importance (string, optional)：重要度レベルでフィルタリング 戻り値：
• ステータスとメッセージの配列を持つオブジェクト 例：

// 最近の高重要度メッセージを取得
const messages = await mcp_cursor10x_getRecentMessages({
  limit: 5,
  importance: "high",
});
// 結果: {
//   "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, optional)：取得する最大ファイル数、デフォルトは10 戻り値：
• ステータスとアクティブなファイルの配列を持つオブジェクト 例：

// 最近のアクティブなファイルを取得
const files = await mcp_cursor10x_getActiveFiles({
  limit: 3,
});
// 結果: {
//   "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, required)：マイルストーンのタイトル
• description (string, required)：マイルストーンの説明
• importance (string, optional)：重要度レベル、デフォルトは "medium"
• metadata (object, optional)：マイルストーンの追加メタデータ 戻り値：
• ステータス、タイトル、およびタイムスタンプを持つオブジェクト 例：

// プロジェクトのマイルストーンを保存
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"],
  },
});
// 結果: {
//   "status": "ok",
//   "title": "Authentication System Implementation",
//   "timestamp": 1681568000123
// }

mcp_cursor10x_storeDecision

プロジェクトの決定事項を長期記憶に保存します。 パラメータ：

• title (string, required)：決定事項のタイトル
• content (string, required)：決定事項の内容
• reasoning (string, optional)：決定の理由
• importance (string, optional)：重要度レベル、デフォルトは "medium"
• metadata (object, optional)：決定事項の追加メタデータ 戻り値：
• ステータス、タイトル、およびタイムスタンプを持つオブジェクト 例：

// プロジェクトの決定事項を保存
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",
  },
});
// 結果: {
//   "status": "ok",
//   "title": "JWT for Authentication",
//   "timestamp": 1681568100456
// }

mcp_cursor10x_storeRequirement

プロジェクトの要件を長期記憶に保存します。 パラメータ：

• title (string, required)：要件のタイトル
• content (string, required)：要件の内容
• importance (string, optional)：重要度レベル、デフォルトは "medium"
• metadata (object, optional)：要件の追加メタデータ 戻り値：
• ステータス、タイトル、およびタイムスタンプを持つオブジェクト 例：

// プロジェクトの要件を保存
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"],
  },
});
// 結果: {
//   "status": "ok",
//   "title": "Secure Authentication",
//   "timestamp": 1681568200789
// }

エピソード記憶ツール

mcp_cursor10x_recordEpisode

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

• actor (string, required)：アクションを実行するアクター (user, assistant, system)
• action (string, required)：実行されるアクションの種類
• content (string, required)：アクションの内容または詳細
• importance (string, optional)：重要度レベル、デフォルトは "low"
• context (string, optional)：エピソードのコンテキスト 戻り値：
• ステータス、アクター、アクション、およびタイムスタンプを持つオブジェクト 例：

// エピソードを記録
const result = await mcp_cursor10x_recordEpisode({
  actor: "assistant",
  action: "implementation",
  content: "Created JWT authentication middleware with token verification",
  importance: "medium",
  context: "authentication",
});
// 結果: {
//   "status": "ok",
//   "actor": "assistant",
//   "action": "implementation",
//   "timestamp": 1681568300123
// }

mcp_cursor10x_getRecentEpisodes

エピソード記憶から最近のエピソードを取得します。 パラメータ：

• limit (number, optional)：取得する最大エピソード数、デフォルトは10
• context (string, optional)：コンテキストでフィルタリング 戻り値：
• ステータスとエピソードの配列を持つオブジェクト 例：

// 認証コンテキストで最近のエピソードを取得
const episodes = await mcp_cursor10x_getRecentEpisodes({
  limit: 5,
  context: "authentication",
});
// 結果: {
//   "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

ベクトル埋め込みの管理を行う統合ツールで、store、search、update、およびdelete操作をサポートします。 パラメータ：

• operation (string, required)：実行する操作 ("store", "search", "update", "delete")
• contentId (number, optional)：このベクトルが表すコンテンツのID (store, update, deleteの場合)
• contentType (string, optional)：コンテンツの種類 ("message", "file", "snippet"など)
• vector (array, optional)：数値の配列としてのベクトルデータ (store, updateの場合) またはクエリベクトル (searchの場合)
• vectorId (number, optional)：更新または削除するベクトルのID
• limit (number, optional)：search操作の最大結果数、デフォルトは10
• threshold (number, optional)：search操作の類似度閾値、デフォルトは0.7
• metadata (object, optional)：ベクトルに関する追加情報 戻り値：
• ステータスと操作結果を持つオブジェクト 例：

// ベクトル埋め込みを保存
const result = await mcp_cursor10x_manageVector({
  operation: "store",
  contentId: 42,
  contentType: "message",
  vector: [0.1, 0.2, 0.3, ...], // 128次元のベクトル
  metadata: {
    topic: "authentication",
    language: "en"
  }
});
// 結果: {
//   "status": "ok",
//   "operation": "store",
//   "vectorId": 15,
//   "timestamp": 1681570000123
// }

// 類似したベクトルを検索
const searchResult = await mcp_cursor10x_manageVector({
  operation: "search",
  vector: [0.1, 0.2, 0.3, ...], // クエリベクトル
  contentType: "snippet", // オプションのフィルタ
  limit: 5,
  threshold: 0.8
});
// 結果: {
//   "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：コードスニペットの内容

💻 使用例

最適化された会話開始

// 1つのツール呼び出しで会話を初期化
// これにより、会話の開始時に3つの個別の呼び出しの必要性が排除されます
const result = await mcp_cursor10x_initConversation({
  content: "I need help implementing authentication in my React app",
  importance: "high",
});

// バナーをユーザーに表示
console.log("Memory System Status:", result.display.banner);

// コンテキストを内部で使用する (ユーザーには表示しない)
const context = result.internal.context;
// より的確な支援にコンテキストを使用する

新しいセッションの開始 (代替方法)

// 開始時にメモリバナーを生成
mcp_cursor10x_generateBanner({});

// 包括的なコンテキストを取得
mcp_cursor10x_getComprehensiveContext({});

// ユーザーメッセージを保存
mcp_cursor10x_storeUserMessage({
  content: "I need help with authentication",
  importance: "high",
});

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

// アクティブなファイルを追跡
await mcp_cursor10x_trackActiveFile({
  filename: "src/auth/jwt.js",
  action: "edit",
});

📄 ライセンス

MIT