grepai-mcp-cursor

Cursor との GrepAI MCP 連携

このスキルでは、Model Context Protocol（MCP）を使用して GrepAI を Cursor IDE と連携する方法を説明します。

このスキルを使用する場面

• Cursor で GrepAI をセットアップする
• Cursor AI でセマンティック検索を有効にする
• Cursor 用の MCP を設定する
• Cursor との連携に関する問題を解決する

Cursor とは？

Cursor は、外部ツール向けの MCP をサポートする AI 搭載 IDE です。GrepAI を連携すると、Cursor の AI で次のことができるようになります。

• 単純なテキスト一致を超えたセマンティックコード検索
• 依存関係を把握するための呼び出しグラフ分析
• インデックスベースのコードナビゲーション

前提条件

1. GrepAI がインストールされていること
2. Ollama（またはその他の埋め込みプロバイダー）が実行中であること
3. プロジェクトのインデックスが作成済みであること（grepai watch）
4. Cursor IDE がインストールされていること

設定

ステップ 1：MCP 設定ファイルを作成する

プロジェクトのルートに .cursor/mcp.json を作成します。

{
  "mcpServers": {
    "grepai": {
      "command": "grepai",
      "args": ["mcp-serve"]
    }
  }
}

ステップ 2：Cursor を再起動する

設定を反映するには、Cursor を終了して再度開きます。

ステップ 3：確認する

Cursor の AI に次のように尋ねます。

「コードベースで認証を検索して」

Cursor は grepai_search ツールを使用します。

グローバル設定

すべての Cursor プロジェクトで GrepAI を使うには、グローバル設定を使用します。

場所

• macOS： ~/.cursor/mcp.json
• Linux： ~/.cursor/mcp.json
• Windows： %APPDATA%\Cursor\mcp.json

内容

{
  "mcpServers": {
    "grepai": {
      "command": "grepai",
      "args": ["mcp-serve"]
    }
  }
}

プロジェクトごとの設定

プロジェクト固有の設定には、次を使用します。

{
  "mcpServers": {
    "grepai": {
      "command": "grepai",
      "args": ["mcp-serve"],
      "cwd": "/absolute/path/to/project"
    }
  }
}

使用可能なツール

設定が完了すると、Cursor から次のツールを利用できます。

ツール	説明
grepai_search	セマンティックコード検索
grepai_trace_callers	関数の呼び出し元を検索
grepai_trace_callees	関数の呼び出し先を検索
grepai_trace_graph	呼び出しグラフを構築
grepai_index_status	インデックスの状態を確認

使用例

コードを探す

Cursor に次のように尋ねます。

「ユーザーログインを処理するコードを探して」

Cursor は grepai_search を使って、意味的に関連するコードを検索します。

依存関係を把握する

Cursor に次のように尋ねます。

「validateToken を呼び出す関数は何ですか？」

Cursor は grepai_trace_callers を使って、すべての呼び出し元を表示します。

コードナビゲーション

Cursor に次のように尋ねます。

「processPayment の呼び出しグラフを表示して」

Cursor は grepai_trace_graph を使って依存関係を表示します。

Cursor の設定との連携

設定で MCP を有効にする

1. Cursor の設定を開きます（Cmd+, / Ctrl+,）
2. 「MCP」を検索します
3. MCP が有効になっていることを確認します

MCP の状態を確認する

1. コマンドパレットを開きます（Cmd+Shift+P / Ctrl+Shift+P）
2. 「MCP」を検索します
3. 接続済みのサーバーを確認します

Windsurf の設定

Windsurf は Cursor と同じ MCP 形式を使用します。

場所

.windsurf/mcp.json を作成します。

{
  "mcpServers": {
    "grepai": {
      "command": "grepai",
      "args": ["mcp-serve"]
    }
  }
}

複数プロジェクトのセットアップ

オプション 1：個別の設定

各プロジェクトに適切な cwd を指定した .cursor/mcp.json を用意します。

オプション 2：ワークスペース

# Create workspace
grepai workspace create dev
grepai workspace add dev /path/to/project1
grepai workspace add dev /path/to/project2

{
  "mcpServers": {
    "grepai": {
      "command": "grepai",
      "args": ["mcp-serve", "--workspace", "dev"]
    }
  }
}

環境変数

GrepAI が環境変数（API キーなど）を使用する場合：

{
  "mcpServers": {
    "grepai": {
      "command": "grepai",
      "args": ["mcp-serve"],
      "env": {
        "OPENAI_API_KEY": "sk-..."
      }
    }
  }
}

推奨： 代わりに、シェルのプロファイルで環境変数を設定します。

トラブルシューティング

MCP が認識されない

❌ 問題： Cursor に GrepAI のツールが表示されません

✅ 解決策：

1. ファイルの場所を確認します。プロジェクトのルートに .cursor/mcp.json があることを確認します
2. JSON の構文を確認します（末尾にカンマがないこと）
3. Cursor を完全に再起動します
4. grepai が PATH に含まれていることを確認します

検索結果が表示されない

❌ 問題： 検索結果が空です

✅ 解決策：

1. インデックスがあることを確認します：grepai status
2. 先に grepai watch を実行します
3. 作業ディレクトリを確認します

接続エラー

❌ 問題： MCP 接続に失敗しました

✅ 解決策：

1. 手動でテストします：grepai mcp-serve
2. Ollama を確認します：curl http://localhost:11434/api/tags
3. Cursor の開発者コンソールでエラーを確認します

検索結果が違う

❌ 問題： 別のプロジェクトの結果が表示されます

✅ 解決策：

1. 設定で cwd を明示的に指定します
2. Cursor で正しいフォルダーを開いていることを確認します
3. grepai_index_status を使って状態を確認します

パフォーマンスのヒント

1. バックグラウンドデーモン： grepai watch --background を実行したままにします
2. コンパクトモードを使用： MCP ツールはデフォルトでコンパクトモードを使用します
3. 結果を制限： AI が適切な上限を指定します
4. 定期的にインデックスを作成： 特に git pull の後に実行します

比較：Cursor と Claude Code

機能	Cursor	Claude Code
設定場所	.cursor/mcp.json	~/.claude/mcp.json
セットアップコマンド	手動で JSON を設定	claude mcp add
プロジェクトの適用範囲	プロジェクトごと、またはグローバル	グローバル
IDE 連携	ネイティブ	ターミナル

ベストプラクティス

1. バージョン管理： .cursor/mcp.json をシークレットなしで Git に追加します
2. チームでのセットアップ： MCP の設定を README に記載します
3. インデックスを最新に保つ： ウォッチデーモンを実行します
4. ローカルでテスト： まず grepai mcp-serve が動作することを確認します
5. ワークスペースを使用： 複数のプロジェクトを設定する場合に使用します

連携の削除

.cursor/mcp.json を削除して、Cursor を再起動します。

または、GrepAI だけを削除します：

{
  "mcpServers": {
    // Remove grepai entry
  }
}

出力形式

Cursor のセットアップが成功した場合：

✅ GrepAI MCP Integration for Cursor

   Config: .cursor/mcp.json
   Server: grepai mcp-serve
   Status: Ready

   Available tools:
   - grepai_search
   - grepai_trace_callers
   - grepai_trace_callees
   - grepai_trace_graph
   - grepai_index_status

   Cursor AI can now search your code semantically!

   Test: Ask Cursor "search for authentication code"