Uruguay: datos públicos

mcp-uruguay

**英文版：**一个 MCP 服务，可让 AI Agent 直接从一手来源获取乌拉圭及周边地区的公共数据： 乌拉圭中央银行汇率及经通胀调整后的比索、阿根廷 CPI、巴西 IPCA、ANCAP 燃油价格、 Salto 的 INIA 天气、乌拉圭河水文站数据、IDE.uy 地理编码以及 RUT/身份证验证。只读， 且每个答复都附带来源和获取时间。

MCP 服务，提供乌拉圭及周边地区的公共数据， 数据直接读取自一手来源。它让任何 AI Agent（Claude 或任何 MCP 客户端）都能获取 BCU 汇率、恒值比索、阿根廷和巴西的 CPI、ANCAP 燃油价格、Salto 天气、乌拉圭河水文站数据， 以及 RUT 和身份证验证。

它基于 uydatos 构建，因此 继承了它的原则：拒绝，而不是修正。收到带有原因的错误的 Agent 可以如实说明；收到 貌似合理却错误数字的 Agent 则会将其复述出去。

工具

工具	回答内容	来源
cotizacion	某一天的美元、UI、阿根廷比索或雷亚尔汇率；如果是周末，会说明采用了哪一个工作日的数据	BCU
cotizacion_mensual	月均值，注明已发布数据的天数，并标记当月数据为部分数据	BCU
pesos_constantes	使用 Unidad Indexada，将不同月份的金额换算为基准月的比索	BCU
variacion_real	扣除通胀后，某笔金额在两个月之间变化了多少（UI、阿根廷 IPC 或 IPCA）	BCU、INDEC、IBGE
ipc_argentina	全国 IPC，基期为 2016 年 12 月 = 100	INDEC
ipca_brasil	IPCA 指数，基期为 1993 年 12 月 = 100	IBGE
combustible_ancap	每种燃料按月公布的最高零售价	ANCAP
paridad_combustibles	ANCAP 的售价高于还是低于进口成本？逐月比较出厂价与进口平价，不含税，并提供从 FOB 开始的明细	URSEA、ANCAP
ventas_combustible	ANCAP 每月按燃料类型和市场销售的数量，并列出来源未发布数据的月份	ANCAP
clima	自 1970 年以来萨尔托的每日降雨量和气温及其异常值，或按十年统计的趋势	INIA
observaciones_inumet	国内七个气象站的气温、降雨量、湿度、风速或气压，按当地日期（UTC-3）汇总；未完整的一天返回 null	INUMET
nivel_rio	乌拉圭河流域某个站点的每日河流水位，以及水位上升或下降的幅度	CTM Salto Grande
nivel_rio_comparado	当前河流水位对这个季节来说偏高还是偏低？与 2017 年以来每年相同日期的数据比较	CTM Salto Grande
estaciones_cercanas	乌拉圭河流域中靠近某个地点的水文气象站	CTM Salto Grande
geocodificar_direccion	地址或街角的坐标及其精度；会排除其他街道或当地中心位置	IDE.uy
ubicar_punto	某个点所在的省和地区，以及该地区 2023 年的人口	INE、IDE.uy
localidad	某个地区的 2023 年人口和住房数量，或按人口排序的各省数据	INE
resultados_electorales	2024 年全国选举、2024 年第二轮选举和 2025 年省级选举：全国或某个省的投票率，以及各政党或候选人的得票数	Corte Electoral
compras_estado	国家机构某一年按机构或文本统计的授标金额（比索），列出金额最大的项目，并在某个项目占总额主导时发出提示	ARCE (OCDS)
asistencia_parlamentaria	按届次统计参议院或众议院会议出席情况，要求达到最低传唤次数，并提示同名者	Parlamento
pedidos_de_informes	众议院向各部委提出的信息请求：按机构、半年和政党统计答复数量，并提供函件和答复的链接	Parlamento
leyes	自 1985 年以来按文本、日期或编号查询颁布的法律，并提供 IMPO 链接	Parlamento
proyectos_parlamento	按文本、届次或类型查询自 1985 年以来提交的法案	Parlamento
validar_documento	RUT 或身份证号码的校验位	离线
semana	某个日期对应的 ISO 周（W41），以及该周的星期一和星期日	离线
buscar_indicador_social	按关键词搜索 MIDES 的约 1,260 项社会指标	MIDES (Observatorio Social)
indicador_social	按维度和年份查询一项社会指标（贫困、就业、教育、住房……），包括其单位、计算方法和来源；数据截至 2024 年	MIDES (Observatorio Social)
recursos_catalogo	catalogodatos.gub.uy 某个数据集当前有效的文件	开放数据目录
diagnostico	查看缓存副本的时间，以及是否已过期	离线

所有工具均为只读，并会向客户端声明这一点。

每个响应都包含两个用于引用数据的字段：

• fuente：发布数据的来源。
• bajado：获取所用副本的时间。

{
  "moneda": "USD",
  "fecha_pedida": "2026-10-04",
  "fecha_cotizacion": "2026-10-02",
  "valor_en_pesos": 40.342,
  "nota": "Se usó la cotización del 2026-10-02, último día publicado antes del 2026-10-04. ...",
  "fuente": "Banco Central del Uruguay, web service de cotizaciones (cotizaciones.bcu.gub.uy)",
  "bajado": "2026-10-09T20:45"
}

工作流与参考资料

除工具外，服务还提供五个提示词（由用户选择的操作指南，说明工具的调用顺序，以及每一步需要留意的问题）和四个资源（客户端按需读取的参考页面）。

提示词	内容
combustible_en_pesos_constantes	同一个月的燃油价格（以比索计），与进口平价和销售量进行比较
clima_de_salto	萨尔托两座公共气象站的降雨量和气温，不取平均值
el_rio_en_salto	将河流水位与其他年份的同期数据比较，并说明单位和水位基准的注意事项
compras_del_estado	国家授予的某种产品采购，不让单个项目造成误导
real_o_nominal	扣除通胀后，判断金额是上涨还是下跌

资源	内容
uru://trampas	每个工具声明的注意事项
uru://fuentes	每项数据的发布方，与 fuente 字段中的引用一致
uru://inumet/estaciones	observaciones_inumet 中的七个气象站
uru://bcu/monedas	cotizacion 支持的各种货币及其含义

如果某个提示词提到了已不存在的工具，或者某个工具没有对应的注意事项，测试就会失败。

安装

需要 uv。无需克隆任何内容。

Claude Code

claude mcp add uruguay -- uvx mcp-uruguay

Claude Desktop 和其他客户端（claude_desktop_config.json 或你的客户端对应的配置文件）

{
  "mcpServers": {
    "uruguay": {
      "command": "uvx",
      "args": ["mcp-uruguay"]
    }
  }
}

之后，可以向 Agent 提问，例如：

• “2026 年 10 月 4 日美元值多少钱？”
• “我在 2025 年 9 月卖了 1,200,000 比索，在 2026 年 9 月卖了 1,450,000 比索。按实际价值计算，我增长了多少？”
• “2026 年 1 月萨尔托的天气比往常更热吗？”
• “萨尔托的乌拉圭河在这个季节水位偏高吗？”
• “坐标 -31.10、-57.30 位于哪个省，最近的城镇是哪里？”
• “萨尔托在 2024 年第二轮选举中的投票情况如何？”
• “2025 年国家在救护车上花了多少钱？”
• “自 2020 年以来通过了哪些有关灌溉的法律？”
• “蒙得维的亚 18 de Julio 街与 Ejido 街附近最近的气象站是哪个？”

缓存

下载的内容会保存在 ~/.cache/mcp-uruguay 中，也可以通过变量 MCP_URUGUAY_CACHE 指定文件夹。

• 已结束的数据不会重新请求： BCU 的已结束月份数据不会变化。
• 实时数据会过期： 当前月份的数据有效期为 3 小时；IPC、IPCA、ANCAP 和气象站数据有效期为 1 天；天气数据有效期为 1 周。
• 无法读取的下载内容绝不会替换有效副本。

首次查询天气时，会下载 INIA 的完整数据系列（约 57 个文件），耗时约一分钟。之后的查询会使用快照。

开发

git clone https://github.com/manusabbath-arch/mcp-uruguay && cd mcp-uruguay
uv run --with pytest --with-editable . pytest            # sin red
uv run --with pytest --with-editable . pytest -m red     # contra las fuentes reales

服务器测试会在同一进程中连接真实的 MCP 客户端，验证工具是否存在、是否全部为只读、错误是否附带原因，以及提示词和资源能否被请求和读取。使用 pytest-cov 衡量覆盖率；如果覆盖率低于 88%，CI 就会失败。

许可证

MIT。可使用、修改和分享；只需保留作者署名声明。