Cambio Uruguay

cambio-uruguay-mcp

あらゆる AI アシスタント（Claude、ChatGPT、Cursor、Cline、…）でウルグアイを検索できる Model Context Protocol サーバーです。世帯全体に合わせたランキング付き賃貸物件、公正な家賃と近隣地域、物件や中古車の有望案件、中古車、商品価格、すべての両替所の最新為替レートを検索できます。

公開されている cambio-uruguay.com API を読み取り専用でラップしています。アカウントも API キーもスクレイピングも不要です。

クイックスタート（ローカル、stdio）

インストール不要です。npx で実行できます。

npx cambio-uruguay-mcp

Claude Desktop

claude_desktop_config.json に追加します（設定 → 開発者 → 設定を編集）。

{
  "mcpServers": {
    "cambio-uruguay": {
      "command": "npx",
      "args": ["-y", "cambio-uruguay-mcp"]
    }
  }
}

Cursor

.cursor/mcp.json（または設定 → MCP）：

{
  "mcpServers": {
    "cambio-uruguay": { "command": "npx", "args": ["-y", "cambio-uruguay-mcp"] }
  }
}

Cline / Continue / その他の stdio クライアント

同じ形式です。コマンドは npx、引数は ["-y", "cambio-uruguay-mcp"] です。

ホスト型エンドポイント（リモート、インストール不要）

リモート MCP サーバーに対応したクライアント向けに、公開 Streamable-HTTP エンドポイントを利用できます。

https://mcp.cambio-uruguay.com/mcp

{
  "mcpServers": {
    "cambio-uruguay": { "url": "https://mcp.cambio-uruguay.com/mcp" }
  }
}

ステートレスで、読み取り専用です。

ツールセット

5 つのツールセットに、読み取り専用ツールが 29 個あります。ホスト型エンドポイントではすべてを /mcp で提供するほか、クライアントが必要なものだけを読み込めるよう、ツールセットごとのパスも用意しています。

パス	ツールセット	対応内容
/mcp	すべて	以下のすべて
/mcp/alquileres	賃貸	5 つのポータルに掲載された約 57,000 件の賃貸住宅、世帯向けランキング、公正な家賃、近隣地域、有望案件
/mcp/autos	中古車	10 の情報源に掲載された約 19,000 台の中古車、有望案件、申告されたリスク、車種別価格、市場レポート
/mcp/productos	商品	携帯電話、デスクチェア、38 の家庭用品カテゴリー、電動モビリティ、オンラインストアの動向、スーパーマーケットの価格
/mcp/sitio	サイト全体	cambio-uruguay.com の全ページ（ガイド、ツール、用語集、データページ）を検索、ページを閲覧、サイトメニューを確認
/mcp/cambio	為替レート	元からある 7 つのツール

stdio の場合は MCP_TOOLSETS=alquileres,autos を設定します（デフォルト：すべて）。

賃貸（alquileres）

ツール	説明
search_rentals	すべての絞り込み条件で賃貸物件を検索します。近隣地域、物件タイプ、寝室数、m²、ペソ建て価格、共益費を含む月額合計、ペット、駐車場、家具付き／家具なし、契約期間（通年または冬季）、受け入れ可能な保証（ANDA、Contaduría、保険会社、敷金、BHU）、設備、オーナー直掲載、ポータル、フリーテキスト、地点と半径による近隣検索、近隣地域の質（犯罪報告が少ない、水道の断水が少ない）。
rank_rentals_for_household	世帯向けにパーソナライズしてランキングします。1〜8 人の世帯について、収入、リモートワークの日数、各人最大 4 つの日常的な目的地（勤務先／学校、週あたりの日数、移動手段）を基に、現在のすべての物件をスコア化します。予算に占める割合、毎月の残額、各人と目的地までの距離、理由、注意事項を表示します。
get_rental	1 件の住宅について、掲載しているすべての広告（ポータルごとの価格）、説明、設備、保証の記載内容、市場比較、類似物件、近隣地域のプロフィールを表示します。
rental_market_stats	地域、近隣地域、物件タイプ、寝室数別に、家賃、共益費、月額合計、1 m² あたり価格の中央値と一般的な範囲を表示します。最も安い近隣地域と最も高い近隣地域も確認できます。
estimate_fair_rent	比較可能な広告を基に、特定の住宅の公正な家賃を推定し、提示価格の位置づけを示します。
compare_neighborhoods	近隣地域を並べて比較します。価格、種類別の犯罪報告、水道の断水、市への苦情、近隣のサービス、モンテビデオの 62 地域中の順位を確認できます。
find_property_opportunities	賃貸または販売で、比較可能な広告より低い価格が付けられた住宅を、その差を裏付ける根拠や注意点とともに見つけます。
geocode_uy_address	住所または交差点 → 座標（IDE Uruguay）。

中古車（autos）

ツール	説明
search_used_cars	ブランド／モデルを通常の名称で検索できます。年式、走行距離、価格（US$）、燃費（L/100 km）の上限、燃料、ギアボックス、ボディタイプ、ドア数、色、県、販売元（ディーラーまたは個人）、掲載元、値下げ、掘り出し物のみ、申告されたリスクなし、過去 N 日以内の掲載で絞り込めます。
find_car_opportunities	固定された同等車群（モデル＋年式＋グレード＋エンジン＋ギアボックス、走行距離が同程度）の相場より安く販売されている車を、各価格差の根拠となるサンプルとともに検索します。
get_car	1件の広告を同等車群、ML 価格ガイド、引用付きの申告リスク、類似車と照合します。
car_model_prices	モデルを年式とバージョンで確認し、ML 価格ガイド、そのモデルのお買い得車と最安の広告を表示します。
car_declared_risks	販売者が債務、書類上の問題、事故、盗難車の回収、機械的な問題、外国ナンバー、または酷使を申告している広告を、引用と問題のない同等車群に対する割引率とともに表示します。
car_market_report	市場レポートの各セクションを表示します。概要、予算ごとに購入できる車、モデル別の減価償却、価格交渉の余地、ディーラーと個人販売の比較、査定への影響などです。

商品（productos）

ツール	説明
search_products	スマートフォン、デスクチェア、38の家庭用品カテゴリ、電動キックボード／電動自転車をまとめて検索します。販売者とリンク付きの妥当な最安商品、新品／中古の一般的な価格帯、中古品での節約額を表示します。
plan_home_setup	何もない家に必要なものをそろえる費用（最低限／標準／充実）を、すでに持っているものを差し引いて算出します。合計が一部のみの場合はその旨を示します。
check_online_store	オンラインストアの信頼性に関する日付付きの情報（ドメインの開設時期、Google、Trustpilot、Redditでの言及、ポリシー、支払い方法）を表示します。断定的な評価は行いません。
supermarket_prices	商品ごとの公式 SIPC 価格と、品目をそろえた買い物かごで比較した県内の最安スーパーを表示します。
list_directories	サイト内のすべてのディレクトリ、その規模、リンクを表示します。

為替レート（cambio）

ツール	説明
get_rates	すべての両替所について、通貨の買値／売値、市場平均、最も有利な買値／売値の両替所、最も低いスプレッド、両替所ごとの一覧を表示します。
best_house	現時点で、通貨を買うのに最適な両替所（売値が最も低い）または売るのに最適な両替所（買値が最も高い）を1か所表示します。
convert	最も有利な市場レートで通貨間の金額を換算します（外国通貨間の換算は UYU を経由します）。
list_houses	追跡対象のすべての両替所を、名称、ウェブサイト、営業対象の県とともに表示します。
get_evolution	両替所と通貨を指定して、過去 N か月の時系列データと統計（最小／最大／平均／現在値／変動）を表示します。
get_news	ウルグアイのドル／経済に関する最新ニュースの見出しを表示します（Google ニュース）。重複は除外され、新しい順に並びます。
daily_summary	AI による市場分析を表示します（市場全体、または currency を指定した場合は通貨別）。lang は es | en | pt です。

レートの見方：通貨を買う場合、両替所があなたに通貨を売ります（最良レートは sell が最も低いもの）。通貨を売る場合、両替所があなたから通貨を買います（最良レートは buy が最も高いもの）。BCU と銀行間レートは市場の計算から除外されます。

プロンプト

buscar-alquiler、evaluar-aviso-alquiler、comparar-barrios、buscar-auto-usado、evaluar-auto、 equipar-casa、analizar-dolar-hoy は、ガイド付きワークフロー（聞き取り、ツールの連携、リンク付きの候補一覧）です。 サーバーは初期化時に、ドメインのルールを含む指示も送信するため、スキルがなくても質の高い回答を維持できます。

スキル（Claude）

skills/buscador-uruguay/ はエージェントスキルで、ワークフローとウルグアイのドメインルールを説明します。また、MCP が接続されていない場合は公開 HTTP API にフォールバックします。 cambio-uruguay.com/descargas/buscador-uruguay-skill.zipから ZIP をダウンロードして Claude にアップロードするか（Settings → Capabilities → Skills）、フォルダーを ~/.claude/skills/ にコピーして Claude Code で使用してください。編集後は npm run pack-skill を実行してください（ZIP に差異があるとテストが失敗します）。

すべてのクライアント向けの手順：cambio-uruguay.com/buscar-con-ia。

設定

環境変数	用途	デフォルト
MCP_TRANSPORT	stdio または http	stdio
MCP_HTTP_PORT	HTTP トランスポートのポート	8788
API_BASE_URL	上流の為替レート API（ツールセット cambio）	https://api.cambio-uruguay.com
SITE_BASE_URL	レンタル、車、製品向けの上流サイト API	https://cambio-uruguay.com
MCP_TOOLSETS	stdio のみ：ツールセットのカンマ区切りリスト（cambio、alquileres、autos、productos、sitio）	すべて

開発

npm install
npm test          # vitest — pure tool handlers
npm run build     # tsc → dist
npm run dev       # run from source (tsx)
npm run inspect   # MCP Inspector against the source server
npm run smoke     # every site-backed tool against production (network)
npm run pack-skill # rebuild the downloadable skill zip

ライセンス

MIT — オープンソースの cambio-uruguay プロジェクトの一部です。