GrepAI MCP統合とCursor

このスキルでは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に次のように質問します：

"Search the codebase for authentication"

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に質問します：

"Find code that handles user login"

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

依存関係の理解

Cursorに質問します：

"What functions call validateToken?"

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

コードナビゲーション

Cursorに質問します：

"Show me the call graph for 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はカーソルと同じMCP形式を使用します：

場所

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

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

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

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

各プロジェクトは適切なcwdを持つ独自の.cursor/mcp.jsonを持ちます。

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

# ワークスペースを作成
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. チームセットアップ: READMEでMCP設定を文書化
3. インデックスを常に最新に: ウォッチデーモンを実行
4. ローカルでテスト: 事前にgrepai mcp-serveが機能することを確認
5. ワークスペースを使用: マルチプロジェクトのセットアップ

統合の削除

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

またはGrepAIのみを削除：

{
  "mcpServers": {
    // grepaiエントリを削除
  }
}

出力形式

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"