GrepAI MCP ツール リファレンス

このスキルは、GrepAI の MCP サーバーを通じて利用可能なすべてのツールの完全なリファレンスを提供します。

このスキルを使う場合

• 利用可能な MCP ツールを理解する
• ツールのパラメータとオプションを学ぶ
• GrepAI を AI アシスタントと統合する
• MCP ツールの使用をデバッグする

MCP サーバーの起動

grepai mcp-serve

サーバーは Model Context Protocol を通じてツールを公開します。

利用可能なツール

1. grepai_search

埋め込みを使用したセマンティックコード検索。

パラメータ

パラメータ	型	必須	デフォルト	説明
query	string	はい	-	検索するものを説明する検索クエリ
limit	number	いいえ	10	返す結果の最大数
compact	boolean	いいえ	false	コンパクト出力を返す (コンテンツなし)
format	string	いいえ	"json"	出力形式: "json" または "toon" (v0.26.0+)

リクエスト例

{
  "tool": "grepai_search",
  "parameters": {
    "query": "user authentication middleware",
    "limit": 5,
    "compact": true,
    "format": "toon"
  }
}

レスポンス (コンパクト)

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

レスポンス (フル)

{
  "query": "user authentication middleware",
  "results": [
    {
      "score": 0.92,
      "file": "src/auth/middleware.go",
      "start_line": 15,
      "end_line": 45,
      "content": "func AuthMiddleware() gin.HandlerFunc {\n    ..."
    }
  ],
  "total": 3
}

---

2. grepai_trace_callers

指定されたシンボルを呼び出すすべての関数を検出します。

パラメータ

パラメータ	型	必須	デフォルト	説明
symbol	string	はい	-	トレースする関数/メソッド名
compact	boolean	いいえ	false	コンパクト出力を返す (コンテキストなし)
format	string	いいえ	"json"	出力形式: "json" または "toon" (v0.26.0+)

リクエスト例

{
  "tool": "grepai_trace_callers",
  "parameters": {
    "symbol": "Login",
    "compact": true
  }
}

レスポンス (コンパクト)

{
  "q": "Login",
  "m": "callers",
  "c": 3,
  "r": [
    {"f": "handlers/auth.go", "l": 42, "fn": "HandleAuth"},
    {"f": "handlers/auth_test.go", "l": 15, "fn": "TestLoginSuccess"},
    {"f": "cmd/main.go", "l": 88, "fn": "RunCLI"}
  ]
}

レスポンス (フル)

{
  "query": "Login",
  "mode": "callers",
  "count": 3,
  "results": [
    {
      "file": "handlers/auth.go",
      "line": 42,
      "caller": "HandleAuth",
      "context": "user.Login(ctx, credentials)"
    }
  ]
}

---

3. grepai_trace_callees

指定されたシンボルによって呼び出されるすべての関数を検出します。

パラメータ

パラメータ	型	必須	デフォルト	説明
symbol	string	はい	-	トレースする関数/メソッド名
compact	boolean	いいえ	false	コンパクト出力を返す (コンテキストなし)
format	string	いいえ	"json"	出力形式: "json" または "toon" (v0.26.0+)

リクエスト例

{
  "tool": "grepai_trace_callees",
  "parameters": {
    "symbol": "ProcessOrder",
    "compact": true
  }
}

レスポンス (コンパクト)

{
  "q": "ProcessOrder",
  "m": "callees",
  "c": 4,
  "r": [
    {"f": "services/order.go", "l": 45, "fn": "validateOrder"},
    {"f": "services/order.go", "l": 48, "fn": "calculateTotal"},
    {"f": "services/order.go", "l": 51, "fn": "applyDiscount"},
    {"f": "services/order.go", "l": 55, "fn": "sendConfirmation"}
  ]
}

---

4. grepai_trace_graph

シンボルから開始して完全なコールグラフを構築します。

パラメータ

パラメータ	型	必須	デフォルト	説明
symbol	string	はい	-	グラフのルート関数
depth	number	いいえ	2	最大再帰深度
compact	boolean	いいえ	false	コンパクト JSON 形式を返す
format	string	いいえ	"json"	出力形式: "json" または "toon" (v0.26.0+)

リクエスト例

{
  "tool": "grepai_trace_graph",
  "parameters": {
    "symbol": "main",
    "depth": 3,
    "compact": true
  }
}

レスポンス (コンパクト)

{
  "q": "main",
  "d": 3,
  "r": {
    "n": "main",
    "c": [
      {
        "n": "initialize",
        "c": [
          {"n": "loadConfig"},
          {"n": "connectDB"}
        ]
      },
      {
        "n": "startServer",
        "c": [
          {"n": "registerRoutes"}
        ]
      }
    ]
  },
  "s": {"nodes": 6, "depth": 3}
}

レスポンス (フル)

{
  "query": "main",
  "mode": "graph",
  "depth": 3,
  "root": {
    "name": "main",
    "file": "cmd/main.go",
    "line": 10,
    "children": [
      {
        "name": "initialize",
        "file": "cmd/main.go",
        "line": 15,
        "children": [...]
      }
    ]
  },
  "stats": {
    "nodes": 6,
    "max_depth": 3
  }
}

---

5. grepai_index_status

コードインデックスのヘルスと状態を確認します。

パラメータ

パラメータ	型	必須	デフォルト	説明
verbose	boolean	いいえ	false	詳細情報を含める
format	string	いいえ	"json"	出力形式: "json" または "toon" (v0.26.0+)

リクエスト例

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

レスポンス

{
  "status": "healthy",
  "project": "/path/to/project",
  "embedder": {
    "provider": "ollama",
    "model": "nomic-embed-text",
    "status": "connected"
  },
  "store": {
    "backend": "gob",
    "location": ".grepai/index.gob"
  },
  "index": {
    "files": 245,
    "chunks": 1234,
    "last_updated": "2025-01-28T10:30:00Z"
  },
  "daemon": {
    "running": true,
    "pid": 12345
  }
}

コンパクト形式リファレンス

compact: true の場合、レスポンスは略語キーを使用します:

フルキー	コンパクトキー	説明
query	q	検索クエリまたはシンボル
results	r	結果の配列
total	t	合計数
count	c	数
score	s	類似度スコア
file	f	ファイルパス
line	l	行番号(複数)
mode	m	トレースモード
depth	d	グラフの深度
name	n	ノード名
children	c	子ノード
stats	s	統計
function	fn	関数名

トークン効率

コンパクトモードはトークンを大幅に削減します:

レスポンス型	フル	コンパクト	削減率
検索 (5結果)	~800	~150	81%
トレースコーラー (10)	~600	~120	80%
トレースグラフ (深さ3)	~1200	~250	79%

エラーレスポンス

インデックスが見つかりません

{
  "error": "Index not found. Run 'grepai watch' first.",
  "code": "INDEX_NOT_FOUND"
}

エンベッダー接続失敗

{
  "error": "Cannot connect to embedding provider. Is Ollama running?",
  "code": "EMBEDDER_UNAVAILABLE"
}

シンボルが見つかりません

{
  "error": "Symbol 'FunctionName' not found in index.",
  "code": "SYMBOL_NOT_FOUND"
}

無効なパラメータ

{
  "error": "Parameter 'query' is required.",
  "code": "INVALID_PARAMETERS"
}

AI 統合のベストプラクティス

1. コンパクトモードを使用: トークン使用量を約80%削減
2. 結果を制限: 必要なものだけをリクエスト
3. 最初にステータスを確認: 検索前に grepai_index_status を使用
4. エラーを処理: エラーレスポンスをチェック
5. ツールを組み合わせ: 完全な理解のために検索とトレースを組み合わせ

MCP プロトコル詳細

リクエスト形式

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "grepai_search",
    "arguments": {
      "query": "authentication",
      "limit": 5,
      "compact": true
    }
  }
}

レスポンス形式

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"q\":\"authentication\",\"r\":[...],\"t\":5}"
      }
    ]
  }
}

出力形式

MCP ツールリファレンス概要:

📚 GrepAI MCP ツール リファレンス

利用可能なツール:

1. grepai_search
   - セマンティックコード検索
   - パラメータ: query*, limit, compact

2. grepai_trace_callers
   - 関数呼び出し元を検出
   - パラメータ: symbol*, compact

3. grepai_trace_callees
   - 関数呼び出し先を検出
   - パラメータ: symbol*, compact

4. grepai_trace_graph
   - コールグラフを構築
   - パラメータ: symbol*, depth, compact

5. grepai_index_status
   - インデックスのヘルスを確認
   - パラメータ: verbose

* = 必須パラメータ

コンパクトモード: 約80%のトークン削減