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。