Uruguay: datos públicos

mcp-uruguay

英語で読む： AI エージェントにウルグアイと地域の公共データを一次情報源から直接提供する MCP サーバーです。ウルグアイ中央銀行の為替レートとインフレ調整後のペソ、アルゼンチンの CPI、ブラジルの IPCA、ANCAP の燃料価格、Salto の INIA 気象データ、ウルグアイ川の観測所、IDE.uy のジオコーディング、RUT／ID の検証に対応しています。読み取り専用で、すべての回答に情報源と取得時刻が付いています。

ウルグアイと地域の公共データを一次情報源から取得する MCP サーバーです。あらゆる AI エージェント（Claude や任意の MCP クライアント）に、BCU の為替レート、実質ペソ、アルゼンチンとブラジルの CPI、ANCAP の燃料価格、Salto の気象データ、ウルグアイ川の観測所、RUT と身分証明書の検証を提供します。

uydatos を基盤としているため、そのルールである 修正せず、拒否する を引き継いでいます。理由付きのエラーを受け取ったエージェントは、そのことを伝えられます。もっともらしいが誤った数値を受け取ったエージェントは、それを繰り返してしまいます。

ツール

ツール	何を返すか	出典
cotizacion	ある日のドル、UI、アルゼンチン・ペソ、またはレアルの為替レート。週末の場合は、使用した営業日を示します	BCU
cotizacion_mensual	月平均。公表された日数を示し、進行中の月には暫定と表示します	BCU
pesos_constantes	Unidad Indexada を使って、異なる月の金額を基準月のペソに換算します	BCU
variacion_real	UI、アルゼンチンの IPC、または IPCA でインフレを差し引いた、2つの月の間の金額の変化を示します	BCU、INDEC、IBGE
ipc_argentina	全国消費者物価指数（基準：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年以降のサルトの毎日の降雨量と気温、その偏差、または10年ごとの傾向を示します	INIA
observaciones_inumet	国内7か所の観測所の気温、降雨量、湿度、風、または気圧を現地日付（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	年ごとに、機関別またはテキスト別に国が落札した金額（ペソ）、主な項目、および1項目が合計を占める割合が大きい場合の警告を示します	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	キャッシュ内の各コピーがいつ取得されたか、および期限切れかどうかを示します	オフライン

すべて読み取り専用であり、その旨をクライアントに宣言します。

各応答には、データの出典を引用するためのフィールドが2つ含まれます。

• 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"
}

ワークフローとリファレンス

ツールに加えて、サーバーは5つのプロンプト（ユーザーが選ぶレシピで、ツールを使う順番と各ステップで注意すべき点が記されています）と、4つのリソース（クライアントが必要に応じて読むリファレンスページ）を公開しています。

プロンプト	作成するもの
combustible_en_pesos_constantes	同じ月のペソ建て燃料価格と、輸入平価および販売量との比較
clima_de_salto	2つの公的観測所のサルトの降雨量と気温。平均は取りません
el_rio_en_salto	サルトの川の水位を、他の年の同じ時期と比較します。単位と水位基準の注意点も示します
compras_del_estado	国がある製品について落札した内容。単一の項目に惑わされないようにします
real_o_nominal	インフレを差し引いた金額が上がったか下がったか

リソース	内容
uru://trampas	各ツールが申告する注意点
uru://fuentes	各データの公開元。fuenteフィールドの記載内容に基づきます
uru://inumet/estaciones	observaciones_inumetの7つの観測所
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"]
    }
  }
}

設定後、エージェントに次のようなことを尋ねてみてください。

• 「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ファイル）をダウンロードするため、1分ほどかかります。2回目以降はスナップショットを使用します。

開発

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です。使用、改変、共有は自由ですが、著作権表示は残してください。