mcp-datos-argentina

mcp-datos-argentina 🇦🇷

Claude（または任意の MCP クライアント）に、リアルタイムのアルゼンチン公共データへのアクセスを提供する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	約1600件の変数を検索（外貨準備、BADLAR、TAMAR、CER、UVA、ICL…）	BCRA – 通貨統計 v4
serie_variable_bcra	IDで指定した変数の過去系列	BCRA – 通貨統計 v4
consultar_deudor	CUIT/CUILの信用状況と不渡り小切手（チェックディジットを検証）	BCRA – 債務者中央台帳 v1
feriados	年間の国民の祝日（または直近の祝日のみ）	argentinadatos.com
inflacion	指定期間の月次および累積IPC	argentinadatos.com
ajustar_por_inflacion	IPCに基づき、ある月の金額を別の月の金額に換算（過去・未来の両方向）	argentinadatos.com
riesgo_pais	最新値、日次および期間内の変動、最小値・最大値。1999年以降の履歴	argentinadatos.com
plazos_fijos	期間と金額に応じた銀行／電子ウォレットの金利ランキング：TNA、TEA、利息、インフレ比の実質金利	argentinadatos.com
normalizar_direccion	住所を正規化して地理的位置を特定。番地がない場合は通りを提示	Georef (datos.gob.ar)
normalizar_direcciones_lote	1回の呼び出しで最大500件の住所を処理し、成功率を表示	Georef (datos.gob.ar)
buscar_lugar	INDEC ID付きの州、郡、市町村、地域、通りを検索	Georef (datos.gob.ar)
ubicacion_por_coordenadas	指定した地点を含む州／郡／市町村を取得	Georef (datos.gob.ar)
buscar_series	公式系列（INDECおよび各省庁）を検索：賃金、EMAE、雇用、項目別IPC…	時系列データ (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

メモ

• Central de Deudoresの金額は、BCRA APIが返す値をそのまま返します。公開ドキュメントには単位（ペソまたは千ペソ）が明記されていないため、相対値として扱うのが適切です。
• インフレ率にはINDECの月次IPCを使用します。調整では、起点の月より後から到達月までの月を対象に複利計算します。
• BCRAの統計API v3は非推奨になりました（410を返します）。このサーバーではv4を使用します。
• 時系列の既知のバグ： last／limitと変換（変化率、前年同期比）を組み合わせると、APIが期間を過去にずらし、直近の期間が省かれます（前年同期比の場合は1年分が省かれます）。consultar_seriesでは、start_dateを指定して回避しています（src/ventana.tsを参照）。
• Georefでは内陸部の多くの道路に番地が登録されていません。その場合、normalizar_direccionは正確な座標の代わりに候補となる道路を返します。
• 年次頻度に集計すると、APIは進行中の年（未完了）を省きます。

ロードマップ

• ARCA登録情報（登録証明書）— Web Service証明書が必要
• カントリーリスクと銀行別定期預金（v0.3.0）
• npmでの公開（npx mcp-datos-argentina）
• MCP公式レジストリへの掲載
• リモート利用向けのHTTPトランスポート（Streamable HTTP）

ライセンス

MIT