Uruguay: datos públicos

io.github.manusabbath-archv0.5.0更新于 Oct 10, 2026

Uruguayan public data from primary sources: BCU rates, CPI, fuel, weather, IDE.uy geocoding, RUT.

概览

AI 生成的概览

只读 MCP 服务器,为助手提供乌拉圭及周边地区的公共数据:BCU 汇率、通胀、燃油、天气、河流、地理编码和 RUT 校验。

功能
提供只读工具,从一手来源获取公共数据:BCU 汇率与月度均值、不变比索与真实变动计算、阿根廷 IPC 与巴西 IPCA、ANCAP 燃油价格、INIA 萨尔托天气、乌拉圭河水位与附近测站、IDE.uy 地理编码与点位查询、INE 城镇人口、2024-2025 选举结果、RUT/身份证校验位、ISO 周、开放数据目录文件以及缓存诊断。每个回答都带有来源字段和获取时间。它对坏数据选择拒绝而非修补,因此错误会附带原因返回,而不是给出看似合理的错误数字。
适用场景
当助手需要可引用的乌拉圭或区域公共统计数据时适用:历史美元或 UI 汇率、通胀调整后的金额、燃油价格、萨尔托天气趋势、河流水位、地址地理编码、城镇人口或近期选举结果。
运行要求
以 PyPI 包 mcp-uruguay 通过 stdio 在本地运行,用 uvx 启动;需要 uv,无需克隆仓库。未声明账户、API 密钥或请求头。多数工具需要网络;证件校验、ISO 周和诊断可离线使用。缓存位于 ~/.cache/mcp-uruguay 或 MCP_URUGUAY_CACHE 指定的路径。首次天气查询会下载约 57 个文件,耗时约一分钟。
安装前请注意
所有工具均声明为只读,且不要求任何凭据。数据从第三方公共来源下载(BCU、INDEC、IBGE、ANCAP、INIA、CTM Salto Grande、IDE.uy、INE、Corte Electoral、catalogodatos.gub.uy),因此查询和缓存副本会离开本机。实时缓存会过期(当月 3 小时;IPC、IPCA、ANCAP 和测站每日;天气每周),结果可能滞后于来源。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Uruguay: datos públicos,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

mcp-uruguay

[tests] [PyPI] [Licencia: MIT]

In English: an MCP server that gives AI agents Uruguayan and regional public data straight from the primary sources: Central Bank of Uruguay exchange rates and inflation-adjusted pesos, Argentina's CPI, Brazil's IPCA, ANCAP fuel prices, INIA weather in Salto, Uruguay River stations, IDE.uy geocoding and RUT/ID validation. Read-only, and every answer carries its source and retrieval time.

Servidor MCP con datos públicos de Uruguay y la región, leídos de la fuente primaria. Le da a cualquier agente de IA (Claude, o cualquier cliente MCP) cotizaciones del BCU, pesos constantes, IPC de Argentina y Brasil, combustibles de ANCAP, clima de Salto, estaciones del río Uruguay y validación de RUT y cédula.

Está construido sobre uydatos, así que hereda su regla: rechazar en vez de arreglar. Un agente que recibe un error con motivo puede decirlo; uno que recibe un número plausible pero falso lo repite.

Herramientas

HerramientaQué respondeFuente
cotizacionDólar, UI, peso argentino o real de un día; si es fin de semana, dice qué día hábil usóBCU
cotizacion_mensualPromedio mensual, con los días publicados y el mes en curso marcado como parcialBCU
pesos_constantesLleva montos de distintos meses a pesos de un mes base, con la Unidad IndexadaBCU
variacion_realCuánto cambió un monto entre dos meses descontando la inflación (UI, IPC argentino o IPCA)BCU, INDEC, IBGE
ipc_argentinaIPC nacional, base dic-2016 = 100INDEC
ipca_brasilIPCA número-índice, base dic-1993 = 100IBGE
combustible_ancapPrecio máximo al público de cada combustible, por mesANCAP
climaLluvia y temperaturas diarias en Salto desde 1970 con su anomalía, o la tendencia por décadaINIA
nivel_rioAltura del río en una estación de la cuenca del río Uruguay, por día, y cuánto subió o bajóCTM Salto Grande
nivel_rio_comparado¿El río está alto o bajo para la época? Contra los mismos días de cada año desde 2017CTM Salto Grande
estaciones_cercanasEstaciones hidrometeorológicas de la cuenca del río Uruguay cerca de un puntoCTM Salto Grande
geocodificar_direccionCoordenadas de una dirección o esquina, con su calidad; descarta otra calle o el centro de la localidadIDE.uy
ubicar_puntoEn qué departamento y localidad cae un punto, con la población 2023 de la localidadINE, IDE.uy
localidadPoblación y viviendas 2023 de una localidad, o las de un departamento ordenadasINE
resultados_electoralesNacionales 2024, balotaje 2024 y departamentales 2025: participación y votos por partido o candidato, del país o un departamentoCorte Electoral
validar_documentoDígito verificador de RUT o cédulasin red
semanaSemana ISO (W41) de una fecha, con su lunes y su domingosin red
recursos_catalogoArchivos vigentes de un dataset de catalogodatos.gub.uyCatálogo de datos abiertos
diagnosticoDe cuándo es cada copia en caché y si está vencidasin red

Todas son de solo lectura, y así lo declaran al cliente.

Cada respuesta trae dos campos para citar el dato:

  • fuente: quién lo publica.
  • bajado: cuándo se obtuvo la copia que se usó.
json
{  "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"}

Instalación

Requiere uv. No hace falta clonar nada.

Claude Code

sh
claude mcp add uruguay -- uvx mcp-uruguay

Claude Desktop y otros clientes (claude_desktop_config.json o el equivalente de tu cliente)

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

Después, preguntale al agente cosas como:

  • "¿Cuánto valía el dólar el 4 de octubre de 2026?"
  • "Vendí 1.200.000 pesos en septiembre de 2025 y 1.450.000 en septiembre de 2026. ¿Cuánto crecí en términos reales?"
  • "¿Hizo más calor de lo normal en Salto en enero de 2026?"
  • "¿El río Uruguay en Salto está alto para esta época del año?"
  • "¿En qué departamento cae el punto -31.10, -57.30, y cuál es el pueblo más cercano?"
  • "¿Cómo votó Salto en el balotaje de 2024?"
  • "¿Cuál es la estación meteorológica más cercana a 18 de Julio y Ejido, en Montevideo?"

Caché

Lo que se baja queda en ~/.cache/mcp-uruguay, o en la carpeta que indique la variable MCP_URUGUAY_CACHE.

  • Lo cerrado no se vuelve a pedir: un mes ya terminado del BCU no cambia.
  • Lo vivo vence: el mes en curso a las 3 horas; el IPC, el IPCA, ANCAP y las estaciones al día; el clima a la semana.
  • Una descarga ilegible nunca reemplaza a una copia buena.

La primera consulta de clima baja la serie completa de INIA (unos 57 archivos) y tarda alrededor de un minuto. Las siguientes son instantáneas.

Desarrollo

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

Los tests del servidor conectan un cliente MCP real en el mismo proceso. Verifican que las 13 herramientas existan, que todas sean de solo lectura y que un error vuelva con su motivo.

Licencia

MIT. Usalo, adaptalo y compartilo; solo mantené el aviso de autoría.

来源:README.md,提交 5372874

工具

0
工具元数据尚未被收录。

版本历史

1
  1. v0.5.0最新Oct 10, 2026