Portugal (public data)

portugal-mcp

ポルトガルの公共データを、ひとつの MCP サーバーで AI アシスタントに。 Claude（または任意の MCP クライアント）に、天気や警報、郵便番号、失業率やインフレ率、Euribor、議会の投票結果、公共契約の落札者、救急外来の混雑状況、医薬品の供給不足の有無、近くで最も安い燃料、ポルト行きの次の列車の出発時刻、今シーズンの火災で焼失した面積などを尋ねられます。

読み取り専用で、API キーもアカウントも不要です。 回答はすべて公式または公開のオープンデータソースに基づき、ソースと対象日を明記します。いずれのソースとも提携していません。

ポルトガル語： ポルトガルの公共データ（IPMA、INE、Banco de Portugal、Parlamento、Portal BASE、dados.gov.pt、SNS、Infarmed、DGEG、MOBI.E、Carris Metropolitana、CP の時刻表、Metro de Lisboa、Carris、Fertagus、EFFIS の火災情報）を扱う MCP サーバーです。読み取り専用で、キーは不要です。ツールはポルトガル語での質問に対応しています。

対応内容

機能	ツール	ソース
clima	weather_forecast, weather_warnings, fire_risk, sea_forecast, earthquakes	IPMA
geo	postal_code, where_is, municipality, public_holidays	GeoAPI.pt（CAOP、CTT、INE の国勢調査データ）。祝日は労働法典に基づいて算出
ine	ine_search, ine_indicator	INE 指標 API
bpstat	bpstat_search, bpstat_series	Banco de Portugal BPstat
parlamento	parliament_search, parliament_initiative, parliament_votes, parliament_deputies	Assembleia da República のオープンデータ
contratos	public_contracts, public_contracts_summary	IMPIC / Portal BASE
dados	open_data_search, open_data_dataset, open_data_preview	dados.gov.pt
saude	sns_find_institutions, sns_emergency_stats, sns_surgery_wait_stats, sns_consultation_wait_stats, sns_search_datasets, sns_query_dataset	SNS Transparency ポータル
medicamentos	medicine_availability, pharmacies, find_medicine_near, medicine_help	Infarmed の公開ページ、営業中の薬局
energia	fuel_prices, fuel_station_detail, fuel_types, ev_chargers, ev_charger_detail	DGEG、MOBI.E
transportes	bus_find_stops, bus_next_arrivals, bus_line_info, bus_service_alerts, bus_vehicle_positions	Carris Metropolitana API
transit	transit_operators, transit_find_stops, transit_departures, transit_trips_between	CP、Metro de Lisboa、Carris、Fertagus の公式 GTFS 時刻表
incendios	wildfires	EFFIS（Copernicus、CC BY 4.0）

ツールは全部で 47 個あります。クライアントが多すぎるツールに対応できない場合は、PORTUGAL_MCP_FEATURES を使って必要なものだけを読み込んでください（下記参照）。

知っておくべきこと

• 統計データには基準期間があります。 INE、BPstat、SNS の数値は、基準期間が設定された公式データ系列であり、多くの場合、数か月前のデータです。回答では基準期間を明記します。
• 健康と医薬品に関する情報は、助言ではありません。 SNS の数値は月次統計であり、救急外来の待ち状況をリアルタイムで示すものではありません。ポルトガルでは薬局ごとの在庫情報は公開されていないため、ツールが薬局に医薬品があると断言することはありません。緊急時は 112 に電話してください。健康に関する相談は SNS 24, 808 24 24 24 に電話してください。
• 議会： 議会が公開しているとおり、投票は会派ごとに記録されます。初回の呼び出しでは約 100 MB をダウンロードするため、1 分ほどかかります。その後、1 日間キャッシュされます。
• 公共契約： 年次の BASE ファイルは 15～55 MB あるため、特定の年に対する初回のクエリには 1～2 分かかります。金額は、発注者が報告した VAT 抜きの契約価格です。個人の納税者番号（NIF）は非表示です。企業および公的機関の NIF は表示されます。
• 燃料／EV： EV に対する初回のクエリでは、全国の MOBI.E フィードを読み込みます（約 80 秒）。その後、キャッシュされます。
• 時刻表は予定情報であり、リアルタイム情報ではありません。 CP、Metro de Lisboa、Carris、Fertagus は公式 GTFS 時刻表を公開しています。初回利用時に各時刻表がローカルの SQLite ファイルに読み込まれ（Carris は約 20 秒）、運行事業者が新しい時刻表を公開すると更新されます。transit_trips_between で検索できるのは直通便のみです（乗り換えなし）。Metro do Porto と STCP は最新の公式フィードを公開していません。
• 山火事の情報は、衛星でマッピングされた焼失地域（EFFIS）に基づいています。 発生から 1 日以上経過した情報であり、リアルタイムの火災情報ではありません。今日の危険度を確認するには fire_risk を使用してください。緊急時は 112 に電話してください。

インストール

Python 3.10 以降が必要です。uv を使う場合、ほかに必要なものはありません。

uvx portugal-mcp --list-tools

または pip を使用します：pip install portugal-mcp。

Claude Code

claude mcp add portugal -- uvx portugal-mcp

Claude Desktop

claude_desktop_config.json に以下を追加してください（claude_desktop_config.snippet.json にもあります）。

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

Codex およびその他の MCP クライアント

stdio サーバーを実行できるクライアントなら、どれでも動作します。コマンドは uvx、引数は ["portugal-mcp"] です。HTTP の場合は portugal-mcp --http を実行してください。127.0.0.1:8000 でストリーミング可能な HTTP を提供します（MCP_HOST／MCP_PORT で変更できます）。

設定

変数	デフォルト	説明
PORTUGAL_MCP_FEATURES	all	読み込む機能（clima,geo,ine）または除外する機能（-contratos,-parlamento）のカンマ区切りリストです。
PORTUGAL_MCP_CACHE_DIR	OS cache dir	ダウンロードしたファイルのキャッシュ先です。
PORTUGAL_MCP_LOG_LEVEL	INFO	ログレベルです。ログは stderr に出力されます。

portugal-mcp --refresh を実行すると、大きなファイル（議会、今年の契約、EV 充電器、時刻表）を事前にダウンロードして終了します。

質問の例

• 「今週、ポルトで雨は降りますか？ 警報は出ていますか？」
• 「今日のモンシケの火災リスクはどのくらいですか？」
• 「ポルトガルの失業率は、最新の月でいくらですか？」
• 「過去 12 か月で 6 か月物 Euribor はどのように推移しましたか？」
• 「今月、議会は住宅について何を採決しましたか？ 各政党の投票はどうでしたか？」
• 「2026 年の随意契約で金額が最も大きいものは何ですか？ リスボン市役所は今年いくら契約しましたか？」
• 「コインブラでイブプロフェンが必要です。在庫切れですか？ 当番薬局はどこですか？」
• 「セトゥーバル近くで最も安い軽油」／「マルケス近くの急速充電器」
• 「カイス・ド・ソドレの停留所に次のバスが来るのはいつですか？」
• 「明日の午前中、リスボン・オリエンテ発ポルト行きの直通列車はありますか？」／「プラゼレスに次に来る 28 番の路面電車は？」
• 「今年、アルガルヴェで何ヘクタールが焼失しましたか？」

開発

python -m venv .venv && .venv/bin/pip install -e ".[dev]"
pytest              # offline unit tests (fixtures, no network)
pytest -m live      # hits every real source; CI runs this daily
ruff check .

機能の構成と情報源を追加する際のルールについては、CONTRIBUTING.md を参照してください。脆弱性の報告方法については、SECURITY.md を参照してください。

メンテナンス

• CI： すべてのプッシュとプルリクエストで、Linux と Windows におけるリンティングとユニットテストに加え、pip-audit を実行します。
• ライブソース： 実際の API に対して毎日実行し、ソースの形式が変更された場合はイシューを作成します。
• Dependabot： 依存関係と GitHub Actions の更新を提案します。Actions はコミット SHA で固定されています。
• リリース： バージョンタグからのみ行い、テストに合格した場合に限ります。PyPI のトラステッドパブリッシングと公式 MCP Registry を通じて公開し、保存されたトークンは使用しません。

置き換え

このパッケージは、同じ作者による以前の 4 つのサーバー（現在は非推奨）を統合したものです。対象は sns-portugal-mcp、portugal-medicines-mcp、portugal-fuel-ev-mcp、carris-metropolitana-mcp です。これらのツールは引き続きこちらで利用できます。SNS、医薬品、バスのツールには接頭辞（sns_、medicine_、bus_）が付いており、47 個のツールの中でも区別できます。

ライセンス

MIT。データの権利は各公開元に帰属し、それぞれのオープンデータ利用条件に基づいて使用しています。再利用する場合は、各公開元を明記してください。