mcp-datos-argentina

mcp-datos-argentina 🇦🇷

MCP 服务，让 Claude（或任何 MCP 客户端）能够实时访问阿根廷公共数据：美元汇率、BCRA、债务人中心、通货膨胀、节假日、地址和地理信息（Georef），以及 INDEC 和各部委的数千条官方序列。

📖 完整手册：MCP 是什么、协议如何运作、安装方法以及每个工具的参考信息。

“蓝美元现在多少钱？”·“2023 年 1 月的 100,000 美元，按今天的价值是多少？”·“CUIT 30-54668997-9 在债务人中心的情况如何？”·“下一个节假日是什么时候？”

工具

工具	功能	来源
cotizaciones_dolar	官方汇率、蓝美元、MEP、CCL、批发汇率、加密货币、信用卡汇率	dolarapi.com
cotizacion_bcra	查询任意货币在任意日期的 BCRA 官方汇率	BCRA – 汇兑统计 v1
buscar_variables_bcra	搜索约 1,600 个变量（储备、BADLAR、TAMAR、CER、UVA、ICL……）	BCRA – 货币统计 v4
serie_variable_bcra	按 ID 查询变量的历史序列	BCRA – 货币统计 v4
consultar_deudor	CUIT/CUIL 的信用状况及拒付支票（验证校验位）	BCRA – 债务人中心 v1
feriados	当年全国节假日（或仅查询即将到来的节假日）	argentinadatos.com
inflacion	指定范围内的月度和累计 CPI	argentinadatos.com
ajustar_por_inflacion	按 CPI 将某月金额换算到另一月份（正向或反向）	argentinadatos.com
riesgo_pais	最新值、日变化和期间变化、最低值/最高值；1999 年以来的历史记录	argentinadatos.com
plazos_fijos	按银行/电子钱包对指定期限和金额的利率排名：TNA、TEA、利息及相对于通货膨胀的实际利率	argentinadatos.com
normalizar_direccion	标准化并地理定位地址；如果没有门牌号，则提供街道建议	Georef (datos.gob.ar)
normalizar_direcciones_lote	单次调用最多处理 500 个地址，并返回成功率	Georef (datos.gob.ar)
buscar_lugar	查询省、行政区、自治市、地方和街道及其 INDEC ID	Georef (datos.gob.ar)
ubicacion_por_coordenadas	查询某个点所在的省/行政区/自治市	Georef (datos.gob.ar)
buscar_series	搜索官方序列（INDEC 和各部委）：工资、EMAE、就业、分类 CPI……	时间序列 (datos.gob.ar)
consultar_series	查询最多 10 个序列的数值、变化百分比、同比变化和频率转换	时间序列 (datos.gob.ar)

所有 API 均无需令牌。响应会缓存在内存中（缓存时间根据来源为 2 分钟至 24 小时）。

安装

需要 Node.js 20 或更高版本。该软件包已发布到 npm，名称为 mcp-datos-argentina，并以 io.github.Gonza28fq/mcp-datos-argentina 的名称列入 MCP 官方注册表。

Claude Code

claude mcp add --scope user datos-argentina -- npx -y mcp-datos-argentina

Claude Desktop

在 claude_desktop_config.json 中：

{
  "mcpServers": {
    "datos-argentina": {
      "command": "npx",
      "args": ["-y", "mcp-datos-argentina"]
    }
  }
}

从源代码安装

git clone https://github.com/Gonza28fq/mcp-datos-argentina.git
cd mcp-datos-argentina
npm install
npm run build
claude mcp add datos-argentina -- node /ruta/a/mcp-datos-argentina/dist/index.js

开发

npm test           # tests unitarios (CUIT, cálculos de inflación)
npm run smoke      # levanta el servidor y llama cada tool contra las APIs reales
npm run inspector  # MCP Inspector para probar a mano
npm run docs       # regenera la referencia de tools en docs/MANUAL.md

结构：

src/
  index.ts      # arranque del servidor (stdio)
  tools.ts      # tools de BCRA, dólar, inflación y feriados
  georef.ts     # tools de normalización geográfica
  series.ts     # tools de series de tiempo oficiales
  mercado.ts    # riesgo país y plazos fijos
  plazofijo.ts  # selección de tasa por plazo/monto y cálculo de TEA y tasa real
  ventana.ts    # workaround del bug de transformaciones de Series de Tiempo
  comun.ts      # helpers compartidos
  http.ts       # fetch con timeout + caché
  cuit.ts       # validación de CUIT/CUIL
  inflacion.ts  # inflación acumulada y ajuste de montos

备注

• 债务人中心的金额按 BCRA API 报告的原样返回。其公开文档未说明单位（比索或千比索），因此建议将其视为相对值。
• 通胀数据使用 INDEC 的月度 IPC；调整会累计来源月份之后至目标月份（含）之间的各月数据。
• BCRA 的 v3 统计 API 已弃用（返回 410）；此服务使用 v4。
• **时间序列已知问题：**将 last/limit 与转换（变化率、同比）结合使用时，API 会将时间窗口向前移动，遗漏最近的时段（同比时会遗漏整整一年）。consultar_series 通过使用 start_date 请求来规避此问题（参见 src/ventana.ts）。
• Georef 未收录许多内陆街道的门牌号：在这些情况下，normalizar_direccion 会返回候选街道，而非精确坐标。
• 汇总为年度频率时，API 会省略当年（数据尚不完整）。

Roadmap

• ARCA 登记名册（注册证明）— 需要 Web Service 证书
• 各银行的国家风险和定期存款（v0.3.0）
• 发布到 npm（npx mcp-datos-argentina）
• 收录于 MCP 官方注册表
• HTTP 传输（Streamable HTTP），用于远程使用

许可证

MIT