mcpField
M
meilisearch-admin

meilisearch-admin

github.com/civitaiData & databases7.3k130 installsUpdated today
Repository

About meilisearch-admin

A command-line skill for administering Meilisearch instances, including health checks, task monitoring, and index settings inspection. It is intended for operators investigating indexing activity or search-service issues across the main and feed/metrics instances.

Key features

  1. 01Check health and overall statistics
  2. 02List recent tasks by status
  3. 03Inspect task details and errors
  4. 04View index statistics and settings
  5. 05Target main or feed instances

Use cases

  1. 01Check whether indexing tasks are stuck processing
  2. 02Find failed tasks and inspect error details
  3. 03Verify searchable or filterable index attributes

Install

Copy the command and run it in a terminal.

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

After installing, type/meilisearch-adminin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

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

Details

From the project README

Meilisearch Admin

Use this skill for admin operations on Meilisearch - checking status, monitoring tasks, and inspecting index settings.

Running Commands

node .claude/skills/meilisearch-admin/query.mjs <command> [options]
Commands
CommandDescription
healthCheck if Meilisearch is healthy
statsGet overall stats and list indexes
task-summaryTask count breakdown by status
tasksList recent tasks
task <id>Get details of a specific task
indexesList all indexes
index <name>Get index stats
index <name> settingsGet all index settings
index <name> filterableGet filterable attributes
index <name> sortableGet sortable attributes
index <name> searchableGet searchable attributes
Options
FlagDescription
--feedUse feed/metrics search (METRICS_SEARCH_HOST) instead of main search
--status <s>Filter tasks by status: enqueued, processing, succeeded, failed
--limit <n>Limit results (default: 20)
--jsonOutput raw JSON
Examples
# 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

Search Instances

The project has two Meilisearch instances:

InstanceEnv VariablesPurpose
Main SearchSEARCH_HOST, SEARCH_API_KEYPrimary search (models, users, etc.)
Feed/MetricsMETRICS_SEARCH_HOST, METRICS_SEARCH_API_KEYImage feed and metrics search

Use --feed flag to target the feed/metrics instance.

Common Indexes

Main Search
  • models_v9 - Model search
  • users_v3 - User search
  • articles_v3 - Article search
Feed/Metrics Search
  • metrics_images_v1 - Image feed with metrics

Debugging Tips

# 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>

Comments

Markdown supported