MCPサーバー

UberLLMはhttps://api.uberllm.dev/mcpにあるMCPサーバーです。これに接続されたエージェントは、HTTPコールを記述することなく、モデルを一覧表示し、リクエストの価格を調べ、画像を生成・編集し、動画を作成し、残高を確認できます。

それは公式MCPレジストリ]にdev.uberllm/mcpとしてリストされているため、レジストリを読み取るクライアントは名前で追加できます。

Streamable HTTPトランスポートを使用しています。/v1で使用しているのと同じAPI keyでサインインしてください。API keyはAuthorization: Bearer ull_...として送信されます。ツールコールは、APIへの同じリクエストとまったく同じように課金され、制限され、拒否されます。つまり、同じ価格、同じキーごとの利用限度額が適用され、失敗したリクエストには費用はかかりません。

Claude コード

$KEY をあなたの API key に置き換えるか、まずシェルで KEY を設定してください:

claude mcp add --transport http uberllm https://api.uberllm.dev/mcp --header "Authorization: Bearer $KEY"

すべてのプロジェクトでそれを使うために --scope user を追加してください。それが接続されたことを確認するために claude mcp list を実行してください。

Claude Desktop

Claude Desktopは、キーを使ってmcp-remote (Node.jsが必要です)]経由でリモートサーバーに接続します。Settings → Developer → Edit Config を開いて、以下を追加してください。

{
  "mcpServers": {
    "uberllm": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.uberllm.dev/mcp", "--header", "Authorization:${UBERLLM_AUTH}"],
      "env": { "UBERLLM_AUTH": "Bearer ull_your_key_here" }
    }
  }
}

ヘッダーの:の後ろにスペースがないのは意図的です。Windowsでは、Claude Desktopがargs内のスペースを引用符で囲まないためです。保存後、Claude Desktopを再起動してください。

Cursor およびその他のクライアント

mcpServersファイルを読み込むクライアント（例えば、Cursorの~/.cursor/mcp.jsonなど）は、以下を受け入れます。

{
  "mcpServers": {
    "uberllm": {
      "url": "https://api.uberllm.dev/mcp",
      "headers": { "Authorization": "Bearer ull_your_key_here" }
    }
  }
}

ツール

Tool	What it does	Spends
`list_models`	今すぐ呼び出せるモデルと、その価格。`type`は`chat`、`image`、`video`、または`music`です。`search`は、IDまたは名前にその単語を含むモデルを保持します。	いいえ
`get_model`	1つのモデル：その価格と、メディアモデルの場合は、そのリクエストが取るオプションのJSON Schemaである`parameters`。	いいえ
`quote`	画像、動画、音楽、またはテキスト読み上げのリクエストをモデルに対してチェックし、何も作成せずに価格を提示します。リストされた価格である`cost_usd`と、実行中に保留される金額および請求される最大額である`max_cost_usd`を返します。	いいえ
`generate_image`	プロンプトから画像を作成します。リンクと`usage.cost_usd`を返します。`return_image: true`を使用すると、画像も回答に含まれて返されます。	はい
`edit_image`	プロンプトに従って、`image_url`の画像（または`input_images`の複数の画像）を変更します。IDが`-edit`で終わるような編集モデルを使用してください。	はい
`start_video`	動画を開始し、ジョブを返します。再試行が2つ目の動画を開始したり、その費用を支払ったりしないように、`idempotency_key`を送信してください。	はい、動画が作成されたとき
`get_job`	動画または音楽ジョブ：ステータス、進行状況、そして成功した場合はそのファイルリンクとコスト。	いいえ
`wait_job`	ジョブが終了するまで、最大`timeout_seconds`（最大50）待ちます。`done`が`false`の場合は、再度呼び出してください。	いいえ
`balance`	現在使用できる金額と、実行中のリクエストおよびジョブのために保留されている金額（米ドル）。	いいえ

モデルがそのparameters Schema（例えばduration_seconds、 resolution、またはaspect_ratio）にリストするオプションは、quote、generate_image、 edit_image、およびstart_videoのoptionsに入ります。それ以上の費用がかかる可能性のあるものを拒否するには、支出ツールでmax_cost（米ドル）を送信してください。

動画の作成には約30秒から数分かかります。通常のフローは、 get_model、quote、start_video、そしてステータスが succeeded、failed、canceled、またはexpiredになるまでwait_jobです。

ファイル

結果リンク(/v1/media/artifacts/...)をダウンロードするには、Authorizationヘッダーに同じAPIキーが必要です。ファイルはジョブの完了後、約3時間保持されます。画像リンクは約15分間です。各リクエストの詳細については、動画または画像を生成するを参照してください。

エラー

APIが呼び出しを拒否した場合、ツールはAPI自身のメッセージとコードを含むエラー結果を返します。例えば insufficient_credits や max_cost_too_low のように。これらのコードはエラー]に記載されています。

キーなしでツールに接続し、一覧表示できます。そのため、MCPディレクトリやインスペクターはサーバーが何をしているかを確認できます。すべてのツール呼び出しにはキーが必要です。キーがない場合、ツールが実行される前に 401 と応答され、何も読み取られたり消費されたりすることはありません。

接続を確認する

curl https://api.uberllm.dev/mcp \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"balance","arguments":{}}}'

あなたの残高で応答します。Authorizationの行がない場合、401と応答します。キーなしでツールを見るには、代わりに"method":"tools/list"を送信してください。