Meilisearch Hybrid Search MCP Server

Meilisearch ハイブリッド検索 MCP サーバー

この MCP（Model Control Protocol）サーバーは、Meilisearch のインデックスに対してハイブリッド検索を実行するツールを提供します。キーワードベースの検索とセマンティックなベクトル検索を組み合わせることができます。

環境変数

サーバーを実行する前に、次の環境変数を設定してください。

export MEILI_HOST="http://your-meilisearch-instance:7700" # Meilisearch host URL
export MEILI_API_KEY="your_api_key"                     # Meilisearch API key (if required)
export MEILI_INDEX="your_index_name"                    # The name of the index to search in
export MEILI_EMBEDDER="your_embedder_name"              # The name of the embedder configured in Meilisearch (e.g., 'default', 'myOpenai')
export MEILI_FILTERABLE_ATTRIBUTES="attr1,attr2"        # Comma-separated filterable attributes for AI awareness (from index settings)

ビルドと実行

サーバーをビルドします。

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 .
# mac
GOOS=macos GOARCH=amd64 go build -o meilisearch-hybrid-search-mcp .

サーバーを実行します。

./meilisearch-hybrid-search-mcp

サーバーは標準入出力で待ち受けます。

利用可能なツール：hybrid_search

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

説明： Meilisearch インデックス内のドキュメントをハイブリッド検索します。

引数：

• keywords（string、必須）：検索クエリのキーワードです。
• semantic_ratio（number、省略可能、デフォルト：0.5）：キーワード検索とセマンティック検索のバランスを調整します。
  • 0.0：キーワード検索のみ。
  • 1.0：セマンティック検索のみ。
  • 0.5：キーワード検索とセマンティック検索のバランスが取れた状態。
• filterable_attribute（string、省略可能）：結果を絞り込む属性名です（例：「genre」、「author」）。filter_word が必要です。
• filter_word（string、省略可能）：指定した filterable_attribute で絞り込む値です（例：「Drama」、「Tolkien」）。filterable_attribute が必要です。