Swervie

Swervie MCP サーバー

AI エージェント向けに、すべての小売業者を横断して商品ごとにスコア付きの回答を1つ提供します。
リモート MCP サーバー · Streamable HTTP · 認証不要 · API キー不要 · 無料

開発者向けドキュメント · ツールリファレンス · クライアントを接続 · レスポンス形式 · データの取り扱い

---

https://us-central1-swervie-prod.cloudfunctions.net/mcp

Swervieは、アシスタント向けに構築された、小売業者横断の商品カタログです。普段どおりの買い物に関する質問をすると、商品ごとにスコア付きの統合された回答を1つ取得できます。最新価格、比較可能な仕様、レビューに基づく評価と原文の引用、各販売店への購入リンクが含まれます。重複した商品リストが8件並んだり、古いまとめ記事が表示されたりすることはありません。

• 統合。 小売業者ごとに掲載された同一商品は、1つの行にまとめられます。異なるブランド名で販売されているホワイトラベル製品もグループ化されます。
• 構造化。 各カテゴリには固有の仕様スキーマがあります。メーカーのページ、小売業者の商品リスト、仕様表から、出典情報とともに仕様を抽出します。
• スコア付き。 各商品には品質スコアと価値スコアが付き、レビューに基づくサブ評価には実際のレビューからの引用が添えられます。
• 決定論的で簡潔。 サービング処理にはLLMを使用しません。回答はパイプラインで事前計算され、約4kトークンで、カテゴリ全体の一覧も1秒未満で返します。
• MCP Appsに対応したホストではインタラクティブ。 結果は、並べ替えコントロール、販売店ごとのオファー、レビューの根拠を備えた商品一覧として表示されます（io.modelcontextprotocol/ui拡張）。それ以外ではプレーンなJSONを返します。

現在、数百の販売店を対象に、ロボット掃除機やテレビからエスプレッソマシン、マットレス、ハイキングブーツまで、300以上のカテゴリをカバーしています。最新の一覧はswervie.xyz/llms.txtにあります。

クイックスタート

Claude Code

claude mcp add --transport http swervie https://us-central1-swervie-prod.cloudfunctions.net/mcp

Cursor、Windsurf、VS Code、Claude Desktop、ChatGPT、Gemini CLIなど： docs/clients.mdをご覧ください。どの設定も、上記のURLを指定する1行だけで、ヘッダーやシークレットは不要です。

curl

MCP=https://us-central1-swervie-prod.cloudfunctions.net/mcp
H=(-H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream')

# Handshake: server info, capabilities, agent instructions
curl -s -X POST $MCP "${H[@]}" -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'

# A whole shopping answer in one call
curl -s -X POST $MCP "${H[@]}" -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_products","arguments":{"query":"65 inch OLED TV under $1500","limit":3}}}'

詳細はexamples/をご覧ください。公式SDKを使ったNodeクライアント、Pythonクライアント、および上記のcurlスクリプトを掲載しています。

ツール

ツール	種類	機能
search_products	読み取り	1回の呼び出しで完結する方法です。自由形式のクエリを、特定の商品、「A vs B」の比較、または条件をフィルター、希望をランキングの優先事項として扱うカテゴリ一覧に解決します。interpretationレシートを返します。
lookup_product	読み取り	名前、ASIN、UPC/EAN/GTIN、またはブランド名とモデル名で商品を1つ検索します。詳細情報、すべての販売店のオファー、およびカテゴリ一覧での順位を返します。
find_category	読み取り	該当するカテゴリと、そのフィルター仕様を返します。フィルター可能な仕様すべてについて、型、単位、選択可能な値、重要度に加え、価格帯を示します。
browse_category	読み取り	明示的なフィルター（必須条件）と希望（任意条件）を適用し、価値、品質、または価格順に並べ替えたカテゴリの商品一覧を返します。
get_products	読み取り	最大25件のIDについて、出典情報付きの全仕様、根拠となる引用付きのレビューサブ評価、すべてのオファーを含む詳細情報を返します。

すべてのツールは読み取り専用で、title、readOnlyHint: true、openWorldHint: trueの注釈が付いているため、ホストは確認プロンプトなしで実行できます。サーバーが提供するのはデータのみです。ユーザーの代わりに何も書き込まず、その指示も結果もモデルに行動を指示しません。稼働中のサーバーから生成された完全な入力スキーマと説明は、docs/tools.mdにあります。

一般的な会話

1. 「1,500ドル未満の65インチOLEDテレビを探してください」→ search_products → 価格、購入リンク、コミッションに関する開示を含む、ランキング順の商品一覧
2. 「その中で、ゲームに適しているのはどれですか？」→ get_products → リフレッシュレート、VRR、HDMI 2.1、入力遅延に関するレビューの評価
3. 「Sony A95Lがもっと安く売られているところはありますか？」→ lookup_product → すべての販売店の価格に加え、商品一覧での順位と、より高いスコアの代替商品

サーバーはinitialize時に、各ツールとその結果に含まれるフィールドを説明する instructionsを送信するため、クライアント側でプロンプトエンジニアリングを行う必要はありません。

ユーザー署名（任意、個人を特定する情報は含めない）

すべてのツールは任意のuser_signatureを受け付けます。これは不透明で安定した仮名IDであり、買い物客ごとに独自のレート制限枠を割り当て（セッションまたは送信元IPごとに共有するのではなく）、購入リンクのクリックを関連付けます。推奨される方法は次のとおりです。

user_signature = "sv1-" + sha256hex("swervie/v1|" + id).slice(0, 24)

ここでidは、ユーザーの最も安定した識別子を正規化したものです（小文字に変換し、前後の空白を削除します。メールアドレスが望ましく、+tagsは削除します）。生の識別子は絶対に送信しないでください。使用できる識別子がない場合は、そのユーザー用に保持したUUIDの前に"sv1r-"を付けて使用するか、このフィールドを省略してください。セッションごとに変わる値を使用すると、毎回新しい買い物客として扱われます。誤って生のメールアドレスや電話番号が届いた場合、サーバーは何かを保存する前にハッシュ化します。

制限、アフィリエイトリンク、プライバシー

• レート制限。 匿名利用枠は、クライアント（署名、セッション、またはIP）ごとに60リクエスト/分、2,000リクエスト/日です。共有エージェントプラットフォームの送信元IP向けには、IP単位でより高い上限が設定されています。独自の利用枠を持つパートナーキーをプラットフォーム向けに提供しています。[email protected]までお問い合わせください。
• 購入リンクはアフィリエイトリンクです。 buy_urlを含むすべてのレスポンスには、買い物客向けの文言を用いたdisclosure文字列も含まれます。コミッションがランキング、スコア、表示される商品に影響することはありません。
• アカウント、チェックアウト、支払いは不要です。 購入時には、販売店のページに移動します。
• 保存される情報。 呼び出しごとのツール名、クエリ、カテゴリ、商品ID、署名がある場合はその署名、およびレート制限カウンターです。ユーザーが所有するものや、ユーザーに代わって書き込まれたものは保存されません。

詳細はdocs/data-handling.mdをご覧ください。ポリシー： プライバシー · 利用規約 · 開示。

このリポジトリの内容

このリポジトリは、Swervie MCP サーバーの公開ホームです。ドキュメント、 レジストリマニフェスト（server.json）、クライアント設定、例、ディレクトリ向けの ブランドアセットを含みます。サーバーの実行コードはSwervieのメインモノレポ内でGoogle Cloud Functionとして稼働しており、ここでは公開されていません。ホストされたエンドポイントが、サポート対象の利用方法です。Issueや機能リクエストも歓迎します。

サーバーバージョンはinitialize（serverInfo.version）によって報告されます。プロトコル バージョンは2025-06-18です。トランスポート：Streamable HTTP、ステートレス。

変更点：v1.6.0（2026-10）では、破壊的変更を伴わない書き込みツール （record_selection、submit_feedback）の2つを削除し、サーバーの指示と 結果の注記をデータの説明として書き直しました。これにより、サーバーは最初から最後まで読み取り専用になりました。

ライセンス

このリポジトリのドキュメント、例、アセットはMITライセンスです （© Plum Applications, Inc.）。ホストされたサービスの利用には、 利用規約が適用されます。