Local Code Indexing for Cursor

Cursor 向けローカルコードインデックス作成

ChromaDB を使用してローカルでコードベースをインデックス化し、Cursor などのツール向けに MCP（Model Context Protocol）サーバー経由でセマンティック検索ツールを提供する、実験的な Python ベースのサーバーです。

セットアップ

1. リポジトリをクローンして移動します。

   git clone <repository-url>
   cd cursor-local-indexing
   

2. .env.example をコピーして .env ファイルを作成します。

   cp .env.example .env
   

3. .env ファイルを設定します。

   PROJECTS_ROOT=~/your/projects/root    # Path to your projects directory
   FOLDERS_TO_INDEX=project1,project2    # Comma-separated list of folders to index
   

   例：

   PROJECTS_ROOT=~/projects
   FOLDERS_TO_INDEX=project1,project2
   

4. インデックス作成サーバーを起動します。

   docker-compose up -d
   

5. ローカル検索サーバーを使用するように Cursor を設定します。 ~/.cursor/mcp.json を作成または編集します。

   {
     "mcpServers": {
       "workspace-code-search": {
         "url": "http://localhost:8978/sse"
       }
     }
   }
   

6. 変更を適用するために Cursor IDE を再起動します。

サーバーが指定したプロジェクトのインデックス作成を開始します。これらのプロジェクトをアクティブにすると、Cursor 内でセマンティックコード検索を利用できるようになります。

7. インデックス対象として設定したプロジェクトを開きます。

.cursorrules ファイルを作成し、次の内容を追加します。

<instructions>
For any request, use the @search_code tool to check what the code does.
Prefer that first before resorting to command line grepping etc.
</instructions>

8. Cursor の Agent モードを使い始めて、ローカルでベクトル検索が行われることを確認します。