Meilisearch MCP Server
2025.02.27
73
Python搜索引擎中间件LLM集成搜索工具开发效率
Meilisearch MCP Server 是一个基于 Model Context Protocol (MCP) 的服务，用于通过类似 Claude 这样的 LLM 接口与 Meilisearch 进行交互。它提供了丰富的功能来管理和操作 Meilisearch 实例，包括索引和文档管理、设置配置、任务监控、API 密钥管理等。
View on GitHub
Overview
基本能力
产品定位
Meilisearch MCP Server 是一个中间件服务，旨在通过标准化的 MCP 协议为大型语言模型（如 Claude）提供与 Meilisearch 搜索引擎的交互能力。
核心功能
- 索引和文档管理：创建、列出索引，添加/检索文档
- 设置配置：查看和更新索引设置（排名规则、分面等）
- 任务监控：跟踪、取消和删除任务
- API 密钥管理：创建、列出和删除 API 密钥
- 智能搜索：支持单索引或跨多索引搜索，带有过滤和排序选项
- 连接管理：动态切换 Meilisearch 实例连接
- 系统监控：健康检查、版本信息、系统统计等
适用场景
- 在 LLM 应用中集成搜索功能
- 需要动态管理多个 Meilisearch 实例的场景
- 开发需要复杂搜索功能的应用程序
- 需要监控和管理 Meilisearch 任务的场景
工具列表
- 连接管理工具：查看和更新连接设置
- 索引管理工具：创建、列出索引，获取索引指标
- 文档操作工具：获取、添加文档
- 搜索工具：灵活搜索功能
- 设置管理工具：获取和更新索引设置
- API 密钥管理工具：创建、列出和删除密钥
- 任务管理工具：获取、取消和删除任务
- 系统监控工具：健康检查、版本信息等
常见问题解答
- 如何切换连接的 Meilisearch 实例？
使用
update-connection-settings工具动态更新 URL 和 API 密钥 - 如何搜索多个索引？
使用
search工具但不指定indexUid参数 - 如何监控任务状态？
使用
get-tasks工具获取任务列表，可添加各种过滤条件
使用教程
使用依赖
- Python ≥ 3.9
- 运行的 Meilisearch 实例
- Node.js（用于 MCP Inspector 测试）
安装教程
# 克隆仓库
git clone <repository_url>
cd meilisearch-mcp
# 创建虚拟环境并安装
uv venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
uv pip install -e .
环境变量设置
MEILI_HTTP_ADDR=http://localhost:7700 # 默认 Meilisearch URL
MEILI_MASTER_KEY=your_master_key # 可选的默认 API 密钥
调试方式
- 启动服务器：
python -m src.meilisearch_mcp
- 使用 MCP Inspector 测试：
npx @modelcontextprotocol/inspector python -m src.meilisearch_mcp
- 与 Claude Desktop 集成配置：
在
claude_desktop_config.json中添加：
{
"mcpServers": {
"meilisearch": {
"command": "uvx",
"args": ["-n", "meilisearch-mcp"]
}
}
}