Cambio Uruguay

cambio-uruguay-mcp

一个 Model Context Protocol 服务，让任何 AI 助手（Claude、ChatGPT、Cursor、Cline、…）都能搜索乌拉圭：按整个家庭的需求排序的出租房、公平租金和社区信息、房产及二手车机会、二手车、商品价格，以及每家兑换所的实时汇率。

这是对公开的 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	完整的出租房目录，支持所有筛选条件：社区、类型、卧室数、平方米、比索价格、含公共费用的月总额、宠物、停车位、带家具或不带家具、租期（全年或冬季）、接受的担保方式（ANDA、Contaduría、保险公司、押金、BHU）、配套设施、房东直租、门户网站、自由文本、指定地点附近 + 半径，以及社区状况（犯罪报告少、停水少）。
rank_rentals_for_household	个性化排序：根据 1–8 人家庭的收入、远程办公天数，以及每人最多 4 个每日目的地（工作／学习、每周天数、出行方式），为所有当前房源评分。提供预算占比、每月剩余金额、每人到各目的地的距离，以及理由和警告。
get_rental	单套房源：发布该房源的每条广告（按门户显示价格）、描述、配套设施、担保说明、市场对比、类似房源和社区概况。
rental_market_stats	按省／社区／类型／卧室数统计租金、中位数及典型区间、公共费用、月总额和每平方米价格；最便宜和最贵的社区。
estimate_fair_rent	根据可比较的广告估算特定房源的公平租金，并指出挂牌价所处的位置。
compare_neighborhoods	并列比较各社区：价格、按类型分类的犯罪报告、停水、市政投诉、附近服务，以及在蒙得维的亚 62 个社区中的排名。
find_property_opportunities	查找挂牌价低于可比广告的房屋（出租或出售），并提供每项价差背后的依据和注意事项。
geocode_uy_address	地址或路口 → 坐标（IDE Uruguay）。

二手车（autos）

工具	描述
search_used_cars	按品牌／车型的普通名称、年份、公里数、价格（美元）、最高百公里油耗（升）、燃料、变速箱、车身类型、车门数、颜色、行政区、经销商或私人卖家、来源、降价情况、是否仅显示优质机会、是否无已声明风险，以及最近 N 天内发布进行筛选。
find_car_opportunities	查找售价低于固定同类车型（车型 + 年份 + 配置 + 发动机 + 变速箱，且公里数相近）的汽车，并提供每个价差对应的样本。
get_car	将一条广告与其同类车型、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	查询当前兑换某种货币最划算的单家兑换机构：买入时卖出价最低，或卖出时买入价最高。
convert	按最佳市场汇率进行货币兑换（外币↔外币通过 UYU 换算）。
list_houses	列出所有已跟踪的兑换机构及其名称、网站和服务行政区。
get_evolution	查询某家兑换机构某种货币过去 N 个月的历史序列和统计数据（最低／最高／平均／当前价及变化）。
get_news	获取最新的乌拉圭美元／经济新闻标题（Google News），去重后按时间从新到旧排列。
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/ 是一项 Agent Skill，用于介绍工作流和乌拉圭领域规则；如果没有连接 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 项目的一部分。