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"        # 用于 AI 意识的可过滤属性（从索引设置中获取），逗号分隔

构建和运行

构建服务器：

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（字符串，必需）：搜索查询的关键字。
• semantic_ratio（数字，可选，默认值：0.5）：控制关键字搜索和语义搜索之间的平衡。
  • 0.0：纯关键字搜索。
  • 1.0：纯语义搜索。
  • 0.5：平衡关键字和语义搜索。
• filterable_attribute（字符串，可选）：用于过滤结果的属性名称（例如："genre", "author"）。需要 filter_word。
• filter_word（字符串，可选）：用于过滤指定 filterable_attribute 的值（例如："Drama", "Tolkien"）。需要 filterable_attribute。