Meilisearch MCP 服务器

一个模型上下文协议 (MCP) 服务器，用于通过 LLM 接口（如 Claude）与 Meilisearch 交互。

<a href="https://glama.ai/mcp/servers/tbc3n51jja"><img width="380" height="200" src="https://glama.ai/mcp/servers/tbc3n51jja/badge" alt="Meilisearch Server MCP server" /></a>

功能

• 索引和文档管理
• 设置配置和管理
• 任务监控和 API 密钥管理
• 内置日志记录和监控工具
• 动态连接配置，可在 Meilisearch 实例之间切换
• 跨单个或多个索引的智能搜索
• 这是一个 Python 实现，如果您需要在浏览器中使用 Meilisearch MCP 服务器，则可以使用 Typescript 集成

安装

# 克隆仓库
git clone <repository_url>
cd meilisearch-mcp

# 创建虚拟环境并安装
uv venv
source .venv/bin/activate  # 在 Windows 上: .venv\Scripts\activate
uv pip install -e .

要求

• Python ≥ 3.9
• 运行中的 Meilisearch 实例
• Node.js (用于使用 MCP Inspector 进行测试)

用法

环境变量

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

动态连接配置

服务器提供工具来查看和更新运行时的连接设置：

• get-connection-settings: 查看当前连接 URL 和 API 密钥状态
• update-connection-settings: 更新 URL 和/或 API 密钥以连接到不同的 Meilisearch 实例

通过 MCP 的示例用法：

// 获取当前设置
{
  "name": "get-connection-settings"
}

// 更新连接设置
{
  "name": "update-connection-settings",
  "arguments": {
    "url": "http://new-host:7700",
    "api_key": "new-api-key"
  }
}

搜索功能

服务器提供了一个灵活的搜索工具，可以搜索一个或所有索引：

• search: 通过 Meilisearch 索引进行搜索，带有可选参数

通过 MCP 的示例用法：

// 在特定索引中搜索
{
  "name": "search",
  "arguments": {
    "query": "search term",
    "indexUid": "movies",
    "limit": 10
  }
}

// 搜索所有索引
{
  "name": "search",
  "arguments": {
    "query": "search term",
    "limit": 5,
    "sort": ["releaseDate:desc"]
  }
}

可用的搜索参数：

• query: 搜索查询（必需）
• indexUid: 要搜索的特定索引（可选）
• limit: 每个索引的最大结果数（可选，默认值：20）
• offset: 要跳过的结果数（可选，默认值：0）
• filter: 过滤器表达式（可选）
• sort: 排序规则（可选）

运行服务器

python -m src.meilisearch_mcp

与 Claude Desktop 一起使用

要将其与 Claude Desktop 一起使用，请将以下内容添加到您的 claude_desktop_config.json：

{
  "mcpServers": {
    "meilisearch": {
      "command": "uvx",
      "args": ["-n", "meilisearch-mcp"]
    }
  }
}

使用 MCP Inspector 进行测试

npx @modelcontextprotocol/inspector python -m src.meilisearch_mcp

可用工具

连接管理

• get-connection-settings: 查看当前 Meilisearch 连接 URL 和 API 密钥状态
• update-connection-settings: 更新 URL 和/或 API 密钥以连接到不同的实例

索引管理

• create-index: 创建一个新索引，带有可选的主键
• list-indexes: 列出所有可用的索引
• get-index-metrics: 获取特定索引的详细指标

文档操作

• get-documents: 从索引中检索文档，带有分页
• add-documents: 在索引中添加或更新文档

搜索

• search: 灵活地跨单个或多个索引进行搜索，带有过滤和排序选项

设置管理

• get-settings: 查看索引的当前设置
• update-settings: 更新索引设置（排名、分面等）

API 密钥管理

• get-keys: 列出所有 API 密钥
• create-key: 创建具有特定权限的新 API 密钥
• delete-key: 删除现有的 API 密钥

任务管理

• get-task: 获取有关特定任务的信息
• get-tasks: 列出带有可选过滤器的任务：
  • limit: 要返回的最大任务数
  • from: 要跳过的任务数
  • reverse: 任务的排序顺序
  • batchUids: 按批处理 UID 过滤
  • uids: 按任务 UID 过滤
  • canceledBy: 按取消源过滤
  • types: 按任务类型过滤
  • statuses: 按任务状态过滤
  • indexUids: 按索引 UID 过滤
  • afterEnqueuedAt/beforeEnqueuedAt: 按入队时间过滤
  • afterStartedAt/beforeStartedAt: 按开始时间过滤
  • afterFinishedAt/beforeFinishedAt: 按完成时间过滤
• cancel-tasks: 取消挂起或已入队的任务
• delete-tasks: 删除已完成的任务

系统监控

• health-check: 基本健康检查
• get-health-status: 综合健康状态
• get-version: 获取 Meilisearch 版本信息
• get-stats: 获取数据库统计信息
• get-system-info: 获取系统级信息

贡献

1. Fork 仓库
2. 创建功能分支
3. 提交更改
4. 创建拉取请求

许可证

MIT