Meilisearch Hybrid Search

🚀 Meilisearch 混合搜索 MCP サーバ

この MCP（モデル制御プロトコル）サーバは、Meilisearch インデックス上で混合検索を実行するためのツールを提供します。キーワードベースの検索と意味ベクトル検索を組み合わせることができます。

🚀 クイックスタート

📦 インストール

サーバーを実行する前に、以下の環境変数を設定する必要があります。

export MEILI_HOST="http://your-meilisearch-instance:7700" # Meilisearch サービスの URL
export MEILI_API_KEY="your_api_key"                     # Meilisearch API キー（必要な場合）
export MEILI_INDEX="your_index_name"                    # 検索対象のインデックス名
export MEILI_EMBEDDER="your_embedder_name"              # Meilisearch で設定された埋め込みモデル名（例: 'default', 'myOpenai'）
export MEILI_FILTERABLE_ATTRIBUTES="attr1,attr2"        # インデックス設定のフィルタ可能属性（カンマ区切り）

🔨 サーバーのビルド

go build -o meilisearch-hybrid-search-mcp .

# Windows
GOOS=windows GOARCH=amd64 go build -o meilisearch-hybrid-search-mcp.exe .
# Linux
GOOS=linux GOARCH=amd64 go build -o meilisearch-hybrid-search-mcp .
# macOS
GOOS=darwin GOARCH=amd64 go build -o meilisearch-hybrid-search-mcp .

▶️ サーバーの実行

./meilisearch-hybrid-search-mcp

サーバーは標準入出力を監視します。

💻 使用例

利用可能なツール: hybrid_search

このツールは、設定された Meilisearch インデックスに対して混合検索を実行します。

説明: Meilisearch インデックス内のドキュメントを混合検索します。

パラメータ:

• keywords (文字列、必須): 検索クエリのキーワード。
• semantic_ratio (数値、オプション、デフォルト値: 0.5): キーワード検索と意味検索のバランスを制御します。
  • 0.0: 純粋なキーワード検索。
  • 1.0: 純粋な意味検索。
  • 0.5: キーワード検索と意味検索のバランスが取れた検索。
• filterable_attribute (文字列、オプション): 結果をフィルタするための属性名（例: "genre", "author"）。filter_word が必要です。
• filter_word (文字列、オプション): 指定された filterable_attribute をフィルタするための値（例: "Drama", "Tolkien"）。filterable_attribute が必要です。