mcpField
M
meilisearch-admin

meilisearch-admin

github.com/civitaiデータ・データベース7.3k130 回インストール今日更新
リポジトリ

meilisearch-admin について

Meilisearch インスタンスの管理に使うコマンドラインスキルで、ヘルスチェック、タスク監視、インデックス設定の確認ができます。メイン検索と Feed／metrics インスタンスのインデックス処理や検索サービスの調査に向いています。

主な機能

  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]
コマンド
コマンド説明
healthMeilisearch が正常に動作しているか確認します
stats全体の統計情報を取得し、インデックスを一覧表示します
task-summaryステータス別のタスク数を表示します
tasks最近のタスクを一覧表示します
task <id>指定したタスクの詳細を取得します
indexesすべてのインデックスを一覧表示します
index <name>インデックスの統計情報を取得します
index <name> settingsすべてのインデックス設定を取得します
index <name> filterableフィルター可能な属性を取得します
index <name> sortableソート可能な属性を取得します
index <name> searchable検索可能な属性を取得します
オプション
フラグ説明
--feedメイン検索の代わりにフィード／メトリクス検索（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

検索インスタンス

このプロジェクトには 2 つの Meilisearch インスタンスがあります。

インスタンス環境変数目的
メイン検索SEARCH_HOST, SEARCH_API_KEY主な検索（モデル、ユーザーなど）
フィード／メトリクスMETRICS_SEARCH_HOST, METRICS_SEARCH_API_KEY画像フィードとメトリクス検索

フィード／メトリクスのインスタンスを対象にするには、--feed フラグを使用します。

主なインデックス

メイン検索
  • models_v9 - モデル検索
  • users_v3 - ユーザー検索
  • articles_v3 - 記事検索
フィード／メトリクス検索
  • metrics_images_v1 - メトリクス付き画像フィード

デバッグのヒント

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