gammainfra

@gammainfra/mcp-server

GammaInfra 向けの Model Context Protocol（MCP）サーバーです。OpenAI 互換の単一 API を介して、主要なあらゆるプロバイダーにわたるインテリジェントな LLM ルーティングを実現します。

このサーバーを Claude Code、Claude Desktop、Cursor、Cline、Continue、または MCP 互換ホストに追加すると、エージェントから次のツールに直接アクセスできます。

• chat_completions — コスト、レイテンシー、品質を制御しながら、サポート対象の任意のモデル（またはスマートルーティング用の gammainfra/auto）を呼び出します。ルーティングメタデータ（リクエストを処理したプロバイダー、正確な USD コスト、フォールバックチェーン）は、構造化された routing_meta フィールドとして返されます。
• list_models — 料金と機能フラグを含む、モデルカタログ全体を表示します。
• get_balance — 管理対象残高と BYOK 残高を表示します。
• get_status — 全体およびプロバイダー別の健全性、過去 24 時間のリクエスト数を表示します。

クイックスタート

1. GammaInfra API キーを取得します。https://gammainfra.com/signup から無料で登録できます（トライアルクレジット $3、クレジットカード不要）。
2. MCP クライアントの設定にサーバーを追加します（クライアント別の手順は以下を参照してください）。
3. クライアントを再起動します。4 つのツールがすぐにエージェントで利用可能になります。

インストール

サーバーは npx で実行するため、手動でインストールする必要はありません。初回の実行時にパッケージがダウンロードされ、キャッシュされます。

Claude Code

claude mcp add gammainfra \
  --env GAMMAINFRA_API_KEY=sk-gammainfra-... \
  -- npx -y @gammainfra/mcp-server

または ~/.claude.json を編集し、mcpServers ブロックに追加します。

{
  "mcpServers": {
    "gammainfra": {
      "command": "npx",
      "args": ["-y", "@gammainfra/mcp-server"],
      "env": { "GAMMAINFRA_API_KEY": "sk-gammainfra-..." }
    }
  }
}

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）を編集します。

{
  "mcpServers": {
    "gammainfra": {
      "command": "npx",
      "args": ["-y", "@gammainfra/mcp-server"],
      "env": { "GAMMAINFRA_API_KEY": "sk-gammainfra-..." }
    }
  }
}

Claude Desktop を再起動します。ツールメニューに「GammaInfra」サーバーが表示されます。

Cursor

~/.cursor/mcp.json を編集します。

{
  "mcpServers": {
    "gammainfra": {
      "command": "npx",
      "args": ["-y", "@gammainfra/mcp-server"],
      "env": { "GAMMAINFRA_API_KEY": "sk-gammainfra-..." }
    }
  }
}

Cline (VS Code)

Cline の設定（歯車アイコン → MCP Servers タブ）を開き、次を追加します。

{
  "gammainfra": {
    "command": "npx",
    "args": ["-y", "@gammainfra/mcp-server"],
    "env": { "GAMMAINFRA_API_KEY": "sk-gammainfra-..." },
    "disabled": false
  }
}

環境変数

Var	必須	デフォルト	説明
GAMMAINFRA_API_KEY	はい	—	GammaInfra API キーです。形式は sk-gammainfra-{32_chars} です。
GAMMAINFRA_BASE_URL	いいえ	https://api.gammainfra.com/v1	ステージング／開発環境用の上書き設定です。

ツールリファレンス

chat_completions

チャット補完リクエストを送信し、モデルの応答とルーティングメタデータを受け取ります。

パラメーター：

Name	Type	必須	説明
model	string	はい	スマートルーティングには gammainfra/auto、ティアのショートカットには gammainfra/fast／gammainfra/cheap を指定します。または、openai/gpt-5-mini のように特定のモデルを指定します。
messages	array	はい	OpenAI 形式の会話メッセージです。
temperature	number	いいえ	0～2。
max_tokens	int	いいえ
max_completion_tokens	int	いいえ	GPT-5 ファミリーでは max_tokens の代わりにこれを指定する必要があります。
cost_quality	float	いいえ	0.0～1.0 の連続調整値です。X-GammaInfra-Cost-Quality として送信されます。
max_latency_ms	int	いいえ	60～600000。フォールバック再試行を含む合計実時間を制限します。また、クライアント側でもハードリクエスト中断条件として適用されます。
preference	string	いいえ	quality、cost、または latency。
region	string	いいえ	us、eu、apac、または特定の AWS リージョン。
tools、tool_choice、response_format、top_p、frequency_penalty、presence_penalty	various	いいえ	標準の OpenAI フィールドです。そのまま転送されます。

戻り値： { response: <OpenAI response>, routing_meta: { provider, endpoint, cost_usd, input_cost_usd, output_cost_usd, router_version, logical_model, fallback_chain, attempted_count, request_id, ... } }

タイムアウトに関する注意： ハングしたアップストリームによって MCP プロセスが停止しないよう、すべてのリクエストには AbortController を使用したクライアント側の 10 分間のハードタイムアウトが設定されています。chat_completions で max_latency_ms が指定されている場合、その値がデフォルトに代わるハード中断時間の上限になります。

ストリーミングに関する注意： MCP ツールの応答はストリーミングされません。サーバーは常に stream: false をアップストリームに送信し、ツール入力の stream パラメーターは受け付けません（スキーマ検証で拒否されます）。ストリーミングを利用する場合は、GammaInfra HTTP API を直接使用してください。

list_models

パラメーターはありません。直接指定するスラッグ、トークンごとの料金、機能フラグ（supports_tools、supports_vision）を含むモデルカタログ全体を返します。

get_balance

名前	型	必須	説明
include_byok	boolean	いいえ	デフォルトは false です。BYOK 残高も取得します。BYOK に登録していないお客様に対する余分なリクエスト（確実に 404 になります）を避けるため、デフォルトでは無効になっています。

{ managed_balance_usd, byok_balance_usd, currency } を返します。include_byok が省略されているか false の場合、byok_balance_usd は null となり、BYOK リクエストは行われません（byok_error もありません）。include_byok: true の場合、BYOK に登録していなければ、byok_balance_usd は null となり、原因を説明する byok_error フィールドが返されます。

get_status

パラメーターはありません。GammaInfra の現在の全体的なヘルス状態、プロバイダーごとの状態とリアルタイムの p50 レイテンシー、および過去 24 時間のリクエスト数を返します。

開発

git clone https://github.com/yuz0101/gammainfra-mcp-server.git
cd gammainfra-mcp-server
npm install
npm run test          # 30 tests, ~1s
npm run build         # tsc → dist/
npm run typecheck

ライセンス

MIT — LICENSE を参照してください。