MCP サーバー概要
laurus-mcp クレートは、Laurus 検索エンジン用の Model Context Protocol (MCP) サーバーを提供します。実行中の laurus-server インスタンスへの gRPC クライアントとして動作し、Claude などの AI アシスタントが標準 MCP stdio トランスポートを通じてドキュメントのインデックス登録や検索を行えるようにします。
機能
- MCP stdio トランスポート — サブプロセスとして起動し、stdin/stdout 経由で AI クライアントと通信
- gRPC クライアント — すべてのツール呼び出しを実行中の
laurus-serverインスタンスにプロキシ - 全 laurus 検索モード — Lexical（BM25）、Vector（HNSW/Flat/IVF）、ハイブリッド検索
- 動的接続 —
connectツールで任意の laurus-server エンドポイントに接続可能 - ドキュメントライフサイクル — MCP ツールを通じてドキュメントの追加・更新・削除・取得が可能
アーキテクチャ
graph LR
subgraph "laurus-mcp"
MCP["MCP Server\n(stdio)"]
end
AI["AI クライアント\n(Claude など)"] -->|"stdio (JSON-RPC)"| MCP
MCP -->|"gRPC"| SRV["laurus-server\n（常駐）"]
SRV --> Disk["ディスク上のインデックス"]
MCP サーバーは AI クライアントによって起動される子プロセスとして動作します。すべてのツール呼び出しを gRPC 経由で laurus-server インスタンスにプロキシします。laurus-server は MCP サーバーとは別途、事前に起動しておく必要があります。
クイックスタート
# ステップ 1: laurus-server を起動
laurus serve --grpc-port 50051
# ステップ 2: Claude Code で MCP サーバーを設定
claude mcp add laurus laurus mcp --endpoint http://localhost:50051
または手動で設定ファイルを編集：
{
"mcpServers": {
"laurus": {
"command": "laurus",
"args": ["mcp", "--endpoint", "http://localhost:50051"]
}
}
}