10-mcp-tools
MCP ツール
このページは自動生成です。直接編集しないこと。
python tools/gen_manual_ref.pyで再生成する。内容を変えたいときは下の生成元を直す。
生成元
crates/melodear-gui/src/mcp_server.rs
GUI に内蔵した MCP サーバ（ADR-0038）が公開しているツール。Claude / Cursor から MeloDear のライブラリを読み書きするための入口。太字は必須引数。接続の仕方は設定の MCP 節と mcp_connect.rs を見る。
ツール（21）
| ツール | 用途 | 引数 |
|---|---|---|
get_status | 開いているライブラリの要約を返す。 | なし |
search_tracks | GUI 検索ボックスと同一構文でトラックを探す（FilterSql::from_user_query）。 | query, limit, offset |
get_track | asset_id 1 件の主要メタデータ、Voice オーバーレイ（声優・タグ・サイト別作品コード）、解析有無（analyzed_at / voice_roles / voice_events）。 | asset_id |
get_transcript | asset_id の転写テキスト（sidecar 字幕優先、なければ whisper）。 | asset_id |
get_product | voice_products の詳細。 | code, asset_id |
get_analysis_coverage | 解析カバレッジ。 | scan_disk |
get_logs | プロセス内リングバッファ（直近最大 2000 行）からログを返す。 | level, target, contains, limit |
get_diagnostics | 環境・設定トグル・ライブラリ要約・サーバ稼働を 1 JSON で返す。 | なし |
get_job_status | スキャン・解析・照合・missing sweep の読み取り専用進捗。 | なし |
list_unmatched_works | 未特定・作品未リンクを作品フォルダ単位で返す（トラック 7 万件は返さない）。 | limit, offset |
set_rating | トラックのレーティング（0–5星）。 | asset_id, stars |
set_loved | loved / Air star。 | asset_id, loved |
set_track_artwork | ローカル画像ファイルからトラックのアートワークを設定（GUI「ファイルからアートワーク設定」と同じ）。 | asset_id, image_path |
edit_product_tags | 作品タグの追加・削除。 | product_code, asset_id, add, remove |
lookup_and_apply | 作品照合。 | asset_id, apply, work_code, ignore_negative_cache |
register_product_for_folder | Nest 規約 <library>/<circle>/<work>/ の作品フォルダから local 作品を登録しトラックを紐付ける。 | asset_ids |
set_product_code | site=local の作品だけを実コード（RJ / d_）へ昇格する。 | product_id, asset_id, work_code |
set_product_artwork | 作品（voice_products.artwork）にローカル画像を設定。 | product_code, asset_id, image_path |
ui_list | MCP UI 操作面の登録表。 | なし |
ui_invoke | 登録済み UI 操作を実行。 | op, args, timeout_ms |
ui_get_state | UI スレッドで state group を一括読み取り。 | group, groups, timeout_ms |
読み取り系（get_* / search_* / list_*）と書き込み系（set_* / edit_* / lookup_and_apply / register_*）、UI 操作系（ui_*）に分かれる。書き込み系はライブラリ DB を変更するので、MELODEAR_MCP_PIN を設定して接続元を絞るのが安全（→ 環境変数）。