modelpulse

modelpulse

modelpulseは、AI Waveのホスト型MCPサーバーへの薄いローカルブリッジです。AIモデルの動向を、ベンダーのリリースノート、Hugging FaceとOpenRouterのカタログ、GitHub、LiteLLMの価格マップからモデルごとに重複を除いて正規化し、単一のフィードとして提供します。変更点、料金、モデルが提供終了になった場合の移行先を追跡します。

このブリッジはカタログを保持せず、計算も行いません。ライブエンドポイントから取得したままの上流サーバーのツール一覧をローカルで提供し、各ツール呼び出しを上流に転送して、結果をそのまま返します。

ツール

• list_model_changes — 変更フィードです。新しいリリース、価格変更、API変更、非推奨化が含まれ、各項目には公式またはレビュー待ちのマークが付いています。省略可能な引数：since（UNIX秒。返されたlatestを次の呼び出しに渡してポーリングします）、type（new_model、price_change、api_change、open_source_surge、deprecation）、model（ベンダーのスラッグ。例：claude）、limit（1～100、デフォルトは20）。
• get_model — 1つのモデルの価格、コンテキスト長、カタログ上のステータスを取得します（必須のidには、anthropic/claude-opus-5のようなOpenRouter ID、またはHugging FaceのリポジトリIDを指定します）。
• get_price_history — 1つのモデルの価格がいつ、どのように変わったかを取得します（必須のid）。履歴はAI Waveが記録を開始した時点からのもので、モデルのリリース時点からではありません。
• search_models — 予算、コンテキスト、機能を基準にモデルを絞り込み、ベンチマークスコアを価格と並べて表示します。省略可能な引数：vendor、maxInputPrice（入力トークン100万件あたりのUSD）、minContext、minIntelligence、sortBy（codingやmathなどの分野、または人気度を表すbuzz）、outputs、mode、accepts、limit（1～50、デフォルトは10）。
• compare_models — 2～6個のモデルを並べて比較します（必須のids）。価格、コンテキスト、分野ごとのスコア（未テストの分野にはゼロではなく未テストのマークを付けます）、および指定量での月額費用（monthlyMillionTokens、デフォルトは10）を表示します。
• estimate_cost — 1つのモデルの月額料金をUSDとKRWで見積もります（必須のid）。monthlyMillionTokens（デフォルトは10）とinputShareの比率（0～1、デフォルトは入力0.75／出力0.25）を基に算出します。
• get_today — 今日の情報を1回の呼び出しで取得します。上位5モデル、順位上昇中のモデル、過去24時間の価格変更、過去7日間の新規掲載が含まれます。引数はありません。
• find_replacement — モデルの提供終了時に移行するモデルを、実測性能の近さで順位付けして提示します（必須のid）。スコア、価格、コンテキストの差分も表示します。元のモデルのコンテキストウィンドウの半分未満の候補は除外されます。

設定

• AIWAVE_MCP_URL（省略可能）— 上流エンドポイントを上書きします。デフォルトは https://aiwave.elopstudio.com/api/mcpです。 （この上書き用フックは、この再構築に独自のものとして明示しています。）
• AIWAVE_API_KEY（省略可能）— 設定すると、すべての上流リクエストにAuthorization: Bearer <key>を付加します。未設定の場合、認証ヘッダーは送信されません。この再構築の基になったキャプチャは、キーなしで取得されました。（この転送機能は、この再構築に独自のものとして明示しています。）

転送の仕組み

最初のツール呼び出し時に、クライアントは上流とのストリーミング可能なHTTPセッションを開きます。まずJSON-RPCのinitializeリクエスト（protocolVersion 2025-03-26、clientInfo name modelpulse）を送り、次にnotifications/initialized通知を送り、その後、呼び出し元の引数を変更せずに含めたtools/callリクエストを送信します。上流がinitializeにMcp-Session-Idヘッダーを付けて応答した場合、その値は以降のセッション内のすべてのリクエストに引き継がれ、プロセスの終了まで同じセッションが再利用されます。応答は通常のJSON、またはサーバー送信イベントとして届く場合があり、どちらも読み取ります。

上流で成功した結果は、上流が設定したisErrorフラグも含め、そのまま返します。JSON-RPCエラー、2xx以外のステータス、読み取れない応答、完了できないリクエストなどの失敗は、テキストがmodelpulse error:で始まるisError結果として返されます（このエラー表現は、この再構築に独自のものとして明示しています）。

CLI

各ツールは、JSON 引数文字列を1つ取るサブコマンドでもあります（引数を取らないツールでは省略します）：

npx @reneturcios/modelpulse get_today
npx @reneturcios/modelpulse get_model '{"id":"anthropic/claude-opus-5"}'
npx @reneturcios/modelpulse compare_models '{"ids":["anthropic/claude-opus-5","openai/gpt-5.2"]}'
npx @reneturcios/modelpulse --version

終了コード：成功時は 0、isError の結果の場合は 1、使用方法の誤りの場合は 2 です。

MCP サーバー

npx -y @reneturcios/modelpulse mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "modelpulse": {
      "command": "npx",
      "args": ["-y", "@reneturcios/modelpulse", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/modelpulse
docker run --rm ghcr.io/cloudcorprecords/modelpulse --version

コンテナのデフォルトコマンドは mcp なので、最初の 形式は stdio MCP サーバーとして動作し、それ以外の引数は通常どおり CLI に渡されます。

開発

npm install
npm run build
npm test
npm run dev

テストスイートはすべてスタブ化された JSON-RPC アップストリームに対して実行され、実際のネットワーク呼び出しは行いません。

ライセンス

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