mcpField
M
meilisearch-admin

meilisearch-admin

github.com/civitai数据与数据库7.3k130 次安装今天更新
代码仓库

关于 meilisearch-admin

用于管理 Meilisearch 实例的命令行技能，可检查健康状态、任务和索引设置。适合需要监控索引处理并排查搜索服务问题的运维人员。

主要功能

  1. 01检查服务健康状态与总体统计
  2. 02按状态查看近期任务
  3. 03查询任务详情和错误
  4. 04查看索引统计及设置
  5. 05切换主搜索与 Feed 实例

适用场景

  1. 01检查索引任务是否卡在处理中
  2. 02定位失败任务及其错误详情
  3. 03核对索引可搜索或可筛选属性

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/civitai/civitai --skill meilisearch-admin

安装后在 Claude Code 中输入/meilisearch-admin确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

.env.example
batch-history.mjs
query.mjs
queue-breakdown.mjs
spike-check.mjs
spike-deep.mjs
task-rate.mjs

详细介绍

Meilisearch 管理

使用此技能管理 Meilisearch：检查状态、监控任务和查看索引设置。

运行命令

node .claude/skills/meilisearch-admin/query.mjs <command> [options]
命令
命令说明
health检查 Meilisearch 是否正常运行
stats获取总体统计信息并列出索引
task-summary按状态统计任务数量
tasks列出最近的任务
task <id>获取特定任务的详情
indexes列出所有索引
index <name>获取索引统计信息
index <name> settings获取所有索引设置
index <name> filterable获取可筛选属性
index <name> sortable获取可排序属性
index <name> searchable获取可搜索属性
选项
标志说明
--feed使用 feed/metrics 搜索（METRICS_SEARCH_HOST），而非主搜索
--status <s>按状态筛选任务：enqueued、processing、succeeded、failed
--limit <n>限制结果数量（默认值：20）
--json输出原始 JSON
示例
# Check health
node .claude/skills/meilisearch-admin/query.mjs health

# Get overall stats
node .claude/skills/meilisearch-admin/query.mjs stats

# Task count summary by status
node .claude/skills/meilisearch-admin/query.mjs task-summary

# Check failed tasks
node .claude/skills/meilisearch-admin/query.mjs tasks --status failed

# Check processing tasks
node .claude/skills/meilisearch-admin/query.mjs tasks --status processing --limit 50

# Get specific task details
node .claude/skills/meilisearch-admin/query.mjs task 2030419

# List all indexes
node .claude/skills/meilisearch-admin/query.mjs indexes

# Get index stats
node .claude/skills/meilisearch-admin/query.mjs index models_v9

# Get filterable attributes for an index
node .claude/skills/meilisearch-admin/query.mjs index metrics_images_v1 filterable

# Use feed search instead of main
node .claude/skills/meilisearch-admin/query.mjs --feed stats
node .claude/skills/meilisearch-admin/query.mjs --feed tasks --status failed

搜索实例

项目有两个 Meilisearch 实例：

实例环境变量用途
主搜索SEARCH_HOST、SEARCH_API_KEY主要搜索（模型、用户等）
Feed/指标METRICS_SEARCH_HOST、METRICS_SEARCH_API_KEY图片 Feed 和指标搜索

使用 --feed 标志以指定 Feed/指标实例。

常用索引

主搜索
  • models_v9 - 模型搜索
  • users_v3 - 用户搜索
  • articles_v3 - 文章搜索
Feed/指标搜索
  • metrics_images_v1 - 带指标的图片 Feed

调试技巧

# Check if indexing is stuck
node .claude/skills/meilisearch-admin/query.mjs tasks --status processing

# Find failed indexing tasks
node .claude/skills/meilisearch-admin/query.mjs tasks --status failed

# Get error details for a failed task
node .claude/skills/meilisearch-admin/query.mjs task <taskId>

# Check if an index is still indexing
node .claude/skills/meilisearch-admin/query.mjs index <indexName>

评论

支持 Markdown