Mintlify Search CLI (msc)

ホストされている MCP エンドポイントを通じて Mintlify ドキュメントをクエリするには msc を使用します。構造化されたコマンド向けに JSON ファーストの出力、コンテンツコマンド向けに生の Markdown を提供し、両者とも LLM トークン消費量に最適化されています。

セットアップ

この MCP エンドポイントを使用してください:

__MSC_MCP_URL__

CLI がまだ設定されていない場合は、すべてのコマンドで --mcp-url __MSC_MCP_URL__ を渡してください。

コアループ(ユースケースの 95%)

# 1. 関連ページを検索
msc search "<query>" --mcp-url __MSC_MCP_URL__ --limit 5

# 2a. トップの結果を直接読み込む
msc open "<query>" --mcp-url __MSC_MCP_URL__

# 2b. または検索で返された "page" フィールドで特定ページを読み込む
msc read "<page>" --mcp-url __MSC_MCP_URL__

実行例:

msc search "list users" --mcp-url __MSC_MCP_URL__
# -> results[0].page = "User/v1/api-rs/list-users" を含む JSON
msc read "User/v1/api-rs/list-users" --mcp-url __MSC_MCP_URL__
# -> 完全な Markdown

エスケープハッチ(稀な場合)

msc fs "tree /Rule -L 3" --mcp-url __MSC_MCP_URL__
msc fs "rg -il 'x-rate-limit' /" --mcp-url __MSC_MCP_URL__
msc fs "cat /openapi/global/openapi.yaml | jq '.paths | keys'" --mcp-url __MSC_MCP_URL__

ガイドライン

• search のデフォルト出力は最小化 JSON です — 人間が読む場合を除き、--text を渡さないでください。
• open は stdout に生の Markdown を出力します。直接パイプ/キャプチャしてください。
• read は .mdx を自動的に解決します — 検索から得た page フィールドをそのまま渡してください。
• 終了コード: 0 = 成功(結果 0 件でも)、1 = ランタイム、2 = 使用方法(例: 空のクエリ)、3 = 設定。
• MCP エンドポイントを直接呼び出さないでください。キャッシュとツール検出を共有するために msc 経由で実行してください。
• 問題があると思われる場合は、msc doctor --mcp-url __MSC_MCP_URL__ --json を使用してください。

コマンド参考

msc search "<query>" [--limit N] [--json|--text|--raw]
msc open   "<query>" [--lines N] [--json|--raw]
msc read   "<path>"  [--lines N | --from L --to M] [--json|--raw]
msc fs     "<command>" [--json|--raw]
msc doctor [--json]
msc config [list|get <key>|set <key> <value>] [--json]