Hubris

Hubris MCP

Hubris 用の Model Context Protocol サーバーです。Hubris は、ルーブル建ての課金に対応した OpenAI 互換の LLM ゲートウェイです。Claude Desktop、Claude Code、Cline、Cursor、その他の MCP クライアントを単一のホスト型サーバーに接続すると、モデルカタログ、アカウント残高と利用額に加え、テキスト、埋め込み、再ランキング、意思決定モデル、画像、音声、文字起こし、動画、YouTube の文字起こしなど、あらゆる種類のモデルを利用できます。

接続方法は 2 つあります。クライアントをホスト型エンドポイントに直接接続する方法と、このリポジトリの stdio サーバーを実行する方法です。後者は同じツールをローカルで公開し、呼び出しをそのエンドポイントに転送します。stdio のみを扱うクライアントや、Dockerfile からビルドするサンドボックスでは、後者を使用してください。

ツール一覧の取得に認証情報は不要ですが、ツールの呼び出しには必要です。HUBRIS_API_KEY を設定すると、stdio サーバーはホスト型エンドポイントからツール一覧をリアルタイムに取得するため、新しいツールが追加されても遅れることはありません。キーを設定しない場合は、パッケージに同梱された一覧を提供します。

• エンドポイント： https://api.hubris.pw/mcp
• トランスポート： Streamable HTTP
• 認証： Bearer API キー（sk-gw-...、hubris.pw/keys で作成できます）
• 詳細ドキュメント： hubris.pw/docs/integrations/mcp

ツール

ツール	説明
models_list	有効なモデルの全カタログをカーソルベースのページネーションで取得します。
models_search	モデルの実行に使うツール（tool）、機能、価格、コンテキスト長で絞り込みます。
models_get_pricing	特定のモデルの料金をルーブル建てで取得します。音声モデルの音声、動画モデルの長さと解像度も確認できます。
balance_get	現在のアカウント残高を取得します。
usage_get	期間内の利用額を取得します。リクエスト数、トークン数、ルーブル建ての金額が含まれます。
chat_complete	LLM のチャットリクエストです。POST /v1/chat/completions と同じです。
embeddings_create	埋め込みベクトルを生成します。POST /v1/embeddings
rerank	クエリとの関連度に基づいてドキュメントを並べ替えます。POST /v1/rerank
decisions_ask	確率付きで、はい／いいえ、選択肢、尺度による回答を取得します。POST /v1/decisions
image_generate	画像を生成し、画像コンテンツとして返します。POST /v1/images/generations
speech_create	テキストを音声に変換し、音声コンテンツとして返します。POST /v1/audio/speech
transcription_create	base64 音声からテキストに変換します。POST /v1/audio/transcriptions
video_create	動画生成を開始します。POST /v1/videos
video_get	動画タスクのステータスを取得します。完了後はダウンロードリンクを取得できます。GET /v1/videos/{id}
youtube_transcribe	YouTube 動画の文字起こしまたは要約を取得します。POST /v1/video/transcriptions

リソース

URI	内容
hubris://catalog/models	単一の JSON ドキュメントとして取得できるモデルの全カタログです。
hubris://docs/quickstart	クイックスタートページです。
hubris://videos/{id}/content	video_get からリンクされた、完成済みの動画です（ホスト型エンドポイントのみ）。

プロンプト

• compare-models {task} — 指定したタスクに適したモデルを比較するための、すぐに使えるプロンプトです。

ローカルで実行（stdio）

npm install && npm run build
HUBRIS_API_KEY=sk-gw-... node dist/index.js

または、Docker を使用します。

docker build -t hubris-mcp .
docker run -i --rm -e HUBRIS_API_KEY=sk-gw-... hubris-mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "hubris": {
      "command": "node",
      "args": ["/path/to/hubris-mcp/dist/index.js"],
      "env": { "HUBRIS_API_KEY": "sk-gw-..." }
    }
  }
}

HUBRIS_MCP_URL を使うと、必要に応じて別のエンドポイントを指定できます。

接続

Claude Code

claude mcp add --transport http hubris https://api.hubris.pw/mcp \
  --header "Authorization: Bearer sk-gw-..."

Claude Desktop

Claude Desktop は stdio のみを扱うため、リモート HTTP サーバーへの接続には mcp-remote シムを使用します。claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "hubris": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.hubris.pw/mcp",
        "--transport",
        "http-only",
        "--header",
        "Authorization:${AUTH_TOKEN}"
      ],
      "env": {
        "AUTH_TOKEN": "Bearer sk-gw-..."
      }
    }
  }
}

Cline / Cursor / その他のクライアント

Streamable HTTP トランスポートをサポートする任意の MCP クライアント：

フィールド	値
トランスポート	Streamable HTTP
URL	https://api.hubris.pw/mcp
認証ヘッダー	Authorization: Bearer sk-gw-...

接続ガイド全文（クライアント固有の注意事項を含む）：hubris.pw/docs/integrations/mcp。

セキュリティ

Bearer キーを使うと、アカウント残高にアクセスできます。他のインテグレーションとは独立して無効化できるよう、MCP 専用のキーを hubris.pw/keys で作成することをおすすめします。

Hubris について

Hubris はロシア市場向けの OpenAI 互換 LLM ゲートウェイです。1 つの API キー、ルーブル建ての残高、400 以上のモデルを利用できます。hubris.pw