Meilisearch MCP Server - MCP服务，MCP服务器，MCP教程

基本能力

产品定位

Meilisearch MCP Server 是一个中间件服务，旨在通过标准化的 MCP 协议为大型语言模型（如 Claude）提供与 Meilisearch 搜索引擎的交互能力。

核心功能

• 索引和文档管理：创建、列出索引，添加/检索文档
• 设置配置：查看和更新索引设置（排名规则、分面等）
• 任务监控：跟踪、取消和删除任务
• API 密钥管理：创建、列出和删除 API 密钥
• 智能搜索：支持单索引或跨多索引搜索，带有过滤和排序选项
• 连接管理：动态切换 Meilisearch 实例连接
• 系统监控：健康检查、版本信息、系统统计等

适用场景

1. 在 LLM 应用中集成搜索功能
2. 需要动态管理多个 Meilisearch 实例的场景
3. 开发需要复杂搜索功能的应用程序
4. 需要监控和管理 Meilisearch 任务的场景

工具列表

1. 连接管理工具：查看和更新连接设置
2. 索引管理工具：创建、列出索引，获取索引指标
3. 文档操作工具：获取、添加文档
4. 搜索工具：灵活搜索功能
5. 设置管理工具：获取和更新索引设置
6. API 密钥管理工具：创建、列出和删除密钥
7. 任务管理工具：获取、取消和删除任务
8. 系统监控工具：健康检查、版本信息等

常见问题解答

1. 如何切换连接的 Meilisearch 实例？
   使用 update-connection-settings 工具动态更新 URL 和 API 密钥
2. 如何搜索多个索引？
   使用 search 工具但不指定 indexUid 参数
3. 如何监控任务状态？
   使用 get-tasks 工具获取任务列表，可添加各种过滤条件

使用教程

使用依赖

• Python ≥ 3.9
• 运行的 Meilisearch 实例
• Node.js（用于 MCP Inspector 测试）

安装教程

```bash

克隆仓库

git clone
cd meilisearch-mcp

创建虚拟环境并安装

uv venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
uv pip install -e .
```

环境变量设置

bash
MEILI_HTTP_ADDR=http://localhost:7700 # 默认 Meilisearch URL
MEILI_MASTER_KEY=your_master_key # 可选的默认 API 密钥

调试方式

1. 启动服务器：
   bash
python -m src.meilisearch_mcp

2. 使用 MCP Inspector 测试：
   bash
npx @modelcontextprotocol/inspector python -m src.meilisearch_mcp

3. 与 Claude Desktop 集成配置：
   在 claude_desktop_config.json 中添加：
   json
{
"mcpServers": {
"meilisearch": {
"command": "uvx",
"args": ["-n", "meilisearch-mcp"]
}
}
}