mcpField
G
grepai-mcp-claude

grepai-mcp-claude

github.com/yoanbernabeuエージェントワークフロー20613 回インストール38 週間前に更新
リポジトリ

grepai-mcp-claude について

GrepAIをClaude Codeに接続するための設定・トラブルシューティング用スキルです。MCP設定に加え、セマンティックコード検索、呼び出しグラフ分析、インデックス監視のツールを説明します。

主な機能

  1. 01GrepAIをMCPサーバーとして設定
  2. 02コードのセマンティック検索
  3. 03呼び出し元と呼び出し先の追跡
  4. 04呼び出しグラフの構築
  5. 05インデックス状態の確認

活用シーン

  1. 01Claude CodeでGrepAIを設定
  2. 02認証関連のコードを検索
  3. 03関数の呼び出し元を調査
  4. 04MCP接続の問題を解決

MCP 対応

GrepAIのMCPサーバーをClaude Codeに接続する手順として、コマンドと手動の設定方法を説明します。連携により、セマンティック検索、呼び出し追跡、呼び出しグラフ、インデックス状態確認のツールを利用できます。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/yoanbernabeu/grepai-skills --skill grepai-mcp-claude

インストール後、Claude Code で/grepai-mcp-claudeを入力して読み込まれたか確認します。

詳細

Claude Code との GrepAI MCP 統合

このスキルでは、Model Context Protocol（MCP）を使用して GrepAI を Claude Code に統合する方法を説明します。

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

  • Claude Code で GrepAI をセットアップするとき
  • AI コーディングアシスタントでセマンティック検索を有効にするとき
  • Claude 用の MCP サーバーを設定するとき
  • Claude Code との統合に関する問題を解決するとき

MCP とは？

Model Context Protocol（MCP）を使うと、AI アシスタントが外部ツールを利用できます。GrepAI は MCP サーバーを提供しており、Claude Code では次のことができます。

  • セマンティックコード検索
  • 呼び出しグラフの分析
  • インデックスの状態監視

前提条件

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

クイックセットアップ

1 つのコマンドで Claude Code に GrepAI を追加できます。

claude mcp add grepai -- grepai mcp-serve

これで完了です。Claude Code から GrepAI のツールを使用できるようになります。

手動での設定

手動でセットアップする場合は、Claude Code の MCP 設定に追加します。

保存場所
  • macOS/Linux： ~/.claude/mcp.json
  • Windows： %APPDATA%\Claude\mcp.json
設定
{
  "mcpServers": {
    "grepai": {
      "command": "grepai",
      "args": ["mcp-serve"]
    }
  }
}
作業ディレクトリを指定する場合

GrepAI が常に特定のプロジェクトを使用するようにするには、次のようにします。

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

インストールの確認

MCP サーバーの確認
# Start MCP server manually to test
grepai mcp-serve

次のように表示されます。

GrepAI MCP Server started
Listening for requests...
Claude Code で確認

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

「コードベース内で認証コードを検索してください」

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

利用可能なツール

接続すると、Claude Code から次のツールを使用できます。

ツール説明パラメーター
grepai_searchセマンティックコード検索query（必須）、limit、compact
grepai_trace_callers関数の呼び出し元を検索symbol（必須）、compact
grepai_trace_callees関数の呼び出し先を検索symbol（必須）、compact
grepai_trace_graph呼び出しグラフを作成symbol（必須）、depth
grepai_index_statusインデックスの状態を確認verbose（任意）

ツールの使用例

セマンティック検索

Claude へのリクエスト：

「ユーザー認証に関連するコードを見つけてください」

Claude が使用するツール：

{
  "tool": "grepai_search",
  "parameters": {
    "query": "user authentication",
    "limit": 5,
    "compact": true
  }
}
トレース分析

Claude へのリクエスト：

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

Claude が使用するツール：

{
  "tool": "grepai_trace_callers",
  "parameters": {
    "symbol": "Login",
    "compact": true
  }
}
インデックスの状態

Claude へのリクエスト：

「コードインデックスは最新ですか？」

Claude が使用するツール：

{
  "tool": "grepai_index_status",
  "parameters": {
    "verbose": true
  }
}

コンパクトモード

デフォルトでは、MCP ツールはトークン数を最小限に抑えるため、コンパクトな JSON を返します。

{
  "q": "authentication",
  "r": [
    {"s": 0.92, "f": "src/auth/middleware.go", "l": "15-45"},
    {"s": 0.85, "f": "src/auth/jwt.go", "l": "23-55"}
  ],
  "t": 2
}

これにより、完全なコンテンツと比較してトークン使用量を約 80％削減できます。

作業ディレクトリ

MCP サーバーは現在の作業ディレクトリを使用します。次の点を確認してください。

  1. プロジェクトで GrepAI が初期化されていること
  2. インデックスが存在すること（先に grepai watch を実行してください）
  3. プロジェクトのディレクトリから Claude Code を起動すること
方法 1：プロジェクトのディレクトリから Claude を起動する
cd /path/to/your/project
claude  # Claude Code now uses this directory
方法 2：MCP 設定で CWD を指定する
{
  "mcpServers": {
    "grepai": {
      "command": "grepai",
      "args": ["mcp-serve"],
      "cwd": "/path/to/your/project"
    }
  }
}

複数のプロジェクト

複数のプロジェクトに対応するには、次の方法があります。

方法 1：複数の MCP サーバー
{
  "mcpServers": {
    "grepai-frontend": {
      "command": "grepai",
      "args": ["mcp-serve"],
      "cwd": "/path/to/frontend"
    },
    "grepai-backend": {
      "command": "grepai",
      "args": ["mcp-serve"],
      "cwd": "/path/to/backend"
    }
  }
}
方法 2：ワークスペースを使用する
grepai workspace create my-workspace
grepai workspace add my-workspace /path/to/frontend
grepai workspace add my-workspace /path/to/backend

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

トラブルシューティング

ツールを使用できない

❌ 問題： Claude に GrepAI のツールが表示されない

✅ 解決策：

  1. 設定を変更した後、Claude Code を再起動します
  2. MCP 設定の構文が正しいこと（有効な JSON であること）を確認します
  3. grepai が PATH に含まれていることを確認します
  4. grepai mcp-serve を手動で実行してテストします
検索結果がない

❌ 問題： 検索結果が空になる

✅ 解決策：

  1. grepai watch が実行済みであることを確認します
  2. 作業ディレクトリに .grepai/ があることを確認します
  3. grepai status でインデックスが存在することを確認します
接続が拒否される

❌ 問題： MCP サーバーが起動しない

✅ 解決策：

  1. Ollama が実行中であることを確認します：curl http://localhost:11434/api/tags
  2. 設定を確認します：cat .grepai/config.yaml
  3. grepai mcp-serve を手動で実行してエラーを確認します
別のプロジェクトがインデックスされている

❌ 問題： 別のコードベースから検索結果が返される

✅ 解決策：

  1. MCP 設定の cwd を確認します
  2. 正しいディレクトリから Claude を起動します
  3. grepai_index_status ツールで確認します

ベストプラクティス

  1. インデックスを最新の状態に保つ： grepai watch --background を実行します
  2. コンパクトモードを使用する： トークンの使用量を削減できます
  3. 作業ディレクトリを設定する： 設定で cwd を明示的に指定します
  4. 最初にステータスを確認する： grepai_index_status を使用します
  5. 設定変更後に再起動する： MCP の変更を反映するには Claude の再起動が必要です

インテグレーションの削除

Claude Code から GrepAI を削除するには：

claude mcp remove grepai

または、~/.claude/mcp.json を手動で編集し、grepai のエントリを削除します。

出力形式

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

✅ GrepAI MCP Integration Configured

   Claude Code: ~/.claude/mcp.json
   Server: grepai mcp-serve
   Status: Connected

   Available tools:
   - grepai_search (semantic code search)
   - grepai_trace_callers (find callers)
   - grepai_trace_callees (find callees)
   - grepai_trace_graph (call graphs)
   - grepai_index_status (index health)

   Claude can now search your code semantically!

コメント

Markdown 対応