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。