HopBase

HopBase MCP サーバー

HopBaseは、Claude、GPT、Gemini、DeepSeekなどのテキスト、画像、動画モデルを、1つのベースURLで提供するAIゲートウェイです。このMCP サーバーを使うと、コーディングエージェントはHopBase APIキーで利用できる機能を確認できます。呼び出せるモデル、各モデルの制限、残高、使用状況を調べられます。

• エンドポイント： https://api.hop-base.com/mcp
• トランスポート： Streamable HTTP、ステートレス、POSTのみ（リクエストごとにJSON-RPCメッセージ1つ。SSEストリームとバッチリクエストには対応していません）
• 認証： Authorization: Bearer <key>またはx-api-key: <key>。モデル呼び出しに使うものと同じAPIキーを使用します。ツールの呼び出しにはキーが必要ですが、ツール一覧の取得には必要ありません
• スコープ： 読み取り専用。すべての結果は、使用中のキーのみを対象とします

これはホスト型サービスであり、ソースコードは公開されていません。このリポジトリには、MCPレジストリマニフェスト（server.json）とクライアント設定が含まれています。

ツール

ツール	返される内容
list_models	このキーで呼び出せるモデルと、適用される価格
get_model_limits	1つのモデルIDについて、このキーで呼び出せるかどうか、モデルに関して記載されたエンドポイント、リクエストパラメーター、制限、および参照元ページへのリンク
search_docs	クエリ（モデルID、パラメーター名、エラーコード）に最も一致するドキュメントのセクション。それぞれURLと抜粋が含まれます。langでen、zh-cn、zh-tw、es、jaを選択できます
get_balance	アカウント残高と、このキーの利用上限の使用状況（USD）
get_key_info	キー名、グループ、利用上限、同時実行数の上限、有効期限、ステータス
get_usage	このキーのリクエスト数、トークン数、請求額。デフォルトは直近7日間で、最大92日間を指定できます

get_model_limitsとsearch_docsは公開ドキュメントを参照し、更新頻度は最大で1時間に1回です。リンク先のドキュメントページが正式な情報源です。結果に制限が記載されていなくても、制限がないことを意味するわけではありません。

セットアップ

HopBase APIキーが必要です。コンソールでキーを作成し、HOPBASE_API_KEYとしてエクスポートしてください。

Claude Code

claude mcp add --transport http hopbase https://api.hop-base.com/mcp \
  --header "Authorization: Bearer $HOPBASE_API_KEY"

コマンドを実行するとシェルが変数を展開するため、キーはClaude Codeのローカル設定に保存されます。プロジェクトで共有する設定を使う場合は、代わりにexamples/claude-code.mcp.jsonをプロジェクトに.mcp.jsonとして配置してください。Claude Codeは起動時に${HOPBASE_API_KEY}を展開するため、ファイルにキーが保存されることはありません。

Cursor

examples/cursor.mcp.jsonをプロジェクトの.cursor/mcp.jsonとして保存するか、すべてのプロジェクトで使う場合は~/.cursor/mcp.jsonとして保存してください。

{
  "mcpServers": {
    "hopbase": {
      "url": "https://api.hop-base.com/mcp",
      "headers": { "Authorization": "Bearer ${env:HOPBASE_API_KEY}" }
    }
  }
}

その他のクライアント

カスタムヘッダーを指定してリモートのStreamable HTTPサーバーに接続できるクライアントであれば、エンドポイントを指定し、上記のAuthorizationヘッダーを送信して接続できます。

知っておくと便利なこと

• MCPから見える内容はキーによって決まります。 list_modelsとget_model_limitsで参照できるのは、設定したキーに割り当てられたグループのみです。別のモデルファミリーを調べるには、そのグループをキーに追加するか、該当グループを含むキーで2つ目のサーバーエントリーを登録してください。
• モデル呼び出しはMCP経由ではありません。 推論には通常のAPIエンドポイント（https://api.hop-base.com/v1：OpenAI Chat CompletionsおよびResponses、Anthropic Messages、GeminiネイティブAPI、画像および動画のタスク用エンドポイント）を使用してください。
• ツールの呼び出しにはキーが必要です。 ハンドシェイク（initialize）とtools/listは認証情報なしで応答するため、クライアントやディレクトリからツールを検出できます。キーなしでtools/callを呼び出すと401が返されます。

リンク

• コーディングエージェント向けガイドとMCPドキュメント：https://hop-base.com/en/docs/getting-started/ai-agent
• ドキュメント：https://hop-base.com/en/docs
• 機械可読な連携仕様：https://hop-base.com/llms.txt
• サポート：[email protected]

ライセンス

このリポジトリ内のファイルはMIT Licenseのもとで公開されています。