SNS Portugal

sns-portugal-mcp

ポルトガルの国民保健サービス（SNS）に関する公式のオープンデータ統計を利用できる MCP サーバーです。Claude（または任意の MCP クライアント）が、「サンタ・マリア病院の救急外来はどれくらい混雑していますか？」「ノルテ地域では何人が手術を待っていますか？」「近くにある SNS の病院はどこですか？」といった質問に答えられます。

読み取り専用で、キーもアカウントも不要です。 公開オープンデータのみを使用します。SNS、SPMS、ポルトガル保健省とは提携していません。

統計であり、リアルタイムの待ち状況ではありません。 数値は公式の月次統計です。最新の月でも通常は2〜3か月前のもので、暫定値です。このサーバーでは、救急外来のリアルタイムの待ち時間は確認できません。リアルタイムの待ち時間については、tempos.min-saude.ptをご覧ください。

医療上の助言ではありません。 緊急時は112に電話してください。健康に関する相談は、808 24 24 24のSNS 24に電話してください。

ツール

find_institutions

SNS の病院と地域保健ユニット（ULS）を、名称または座標から近い順に検索します。各結果には、その施設が救急、診療、手術のデータを報告しているかどうかと、統計で使用されている名称であるstats_entityが含まれます。統計は建物ごとではなく、ULS または病院グループごとに公開されています。

パラメーター：query（名称。アクセント記号の有無を区別しません）、lat / lon（距離順で並べ替え）、emergency_only、limit。

emergency_stats

救急外来の月別受診数を、種類（一般、小児、産科、精神科）およびマンチェスター・トリアージの色（赤、オレンジ、黄、緑、青、白、未トリアージ）ごとに表示し、各色の月間割合も示します。1つの施設、1つの地域、または全国を対象にできます。

パラメーター：institution、region（Norte | Centro | LVT | Alentejo | Algarve）、period（含める最新月を示す"YYYY-MM"）、months（デフォルトは6）。

surgery_wait_stats

月別の手術関連情報を表示します。

• 月末時点の手術待機リスト（LIC）
• 待機中の患者のうち、法定保証期間（TMRG）以内の割合
• 入院から手術までの日数の平均（予定入院手術）
• 実施された手術数：予定手術（入院および日帰り手術）と緊急手術

emergency_statsと同じパラメーターです。オープンデータには、専門分野別の内訳はありません。

consultation_wait_stats

病院の月別外来診療数（初診および再診）と、家庭医から紹介された専門医の初診のうち、TMRG 以内に実施された割合を表示します。上記と同じパラメーターです。

search_datasets

SNS 透明性ポータルの149件のデータセットをキーワードで検索します。タイトルはポルトガル語のため、ポルトガル語のキーワード（"ocupação"、"partos"、"rastreios"、"SNS 24"、"INEM"）が最適です。各データセットの ID、説明、フィールド名を返します。

query_dataset

任意のポータルデータセットに対して ODSQL クエリ（where、select、group_by、order_by、limit、offset）を実行します。上記のツールで対応できない情報を取得する際に使用します。

年初来の値

ほとんどの病院活動データセットでは、年初からの累計値が公開されるため、12月の数値が年間合計になります。厳選されたツールでは、年初来の値と、そこから算出したin_month（当月の値から前月の値を差し引いたもの）の両方を返します。query_datasetを直接使用する場合は、この差し引きをご自身で行ってください。

インストール

最も手軽な方法（uvが必要）：クローンは不要で、PyPI から直接実行できます。

claude mcp add sns-portugal -- uvx sns-portugal-mcp

Claude Desktop では、"command": "uvx", "args": ["sns-portugal-mcp"]を使用してください。

ソースからインストールする場合：

Python 3.10 以降が必要です。

git clone https://github.com/ThiagoJacobLannes/sns-portugal-mcp
cd sns-portugal-mcp
python -m pip install -e .

Windows でコードをクラウド同期フォルダー（Google Drive、OneDrive）に保存する場合は、仮想環境をその外に作成してください。同期クライアントがフォルダーにdesktop.iniファイルを作成し、起動時にパッケージがクラッシュすることがあります。

Claude Code に追加する

claude mcp add sns-portugal -- python -m sns_portugal_mcp.server

Claude Desktop に追加する

claude_desktop_config.snippet.jsonを Claude Desktop のclaude_desktop_config.jsonにマージし、Claude Desktop を再起動してください。

{
  "mcpServers": {
    "sns-portugal": {
      "command": "python",
      "args": ["-m", "sns_portugal_mcp.server"]
    }
  }
}

データソース

ソース	提供されるデータ	アクセス	ライセンス／利用条件
SNS Transparency portal（Opendatasoft Explore API v2.1）	SNS Executive Direction（DE-SNS）が公開する、SNS の月次統計データセット149件	オープン、キー不要	2026-10-31の確認時点で、どのデータセットのメタデータにもライセンスは設定されていません。ポータルの利用条件では、ポルトガルの公共部門情報に関する法律（Lei n.º 26/2016）に基づく再利用が認められています。出典を明記し、データの完全性と文脈を維持し、変更を加えた場合はその旨を示してください。同じデータセットの一部はdados.gov.ptにもミラーされています。こちらでは、一部のコピーにCC-BY、その他には「未指定」と記載されています。
tempos.min-saude.pt/institutions.json	病院とULSの一覧、座標、および各施設が報告するデータ	公開静的ファイル、キー不要	ライセンスの記載はありません。

キュレーションされたツールで使用するデータセット：

ツール	データセット
emergency_stats	atendimentos-por-tipo-de-urgencia-hospitalar-link、atendimentos-em-urgencia-triagem-manchester
surgery_wait_stats	inscritos-em-lic-dentro-do-tmrg-180-dias、demora-media-antes-da-cirurgia、intervencoes-cirurgicas
consultation_wait_stats	consultas-em-tempo-real、01_sica_evolucao-mensal-das-consultas-medicas-hospitalares

これらのソースから派生したデータには、ソースの利用条件が適用されます。このリポジトリのコードはMITライセンスです。

このサーバーが行わないこと。 tempos.min-saude.pt/api/*への呼び出しは行いません。このAPIにはサイト独自のウェブアプリに埋め込まれたキーが必要ですが、このサーバーは他者のキーを使用しません。また、ライブの待ち時間レポート（埋め込みPower BIレポート）のスクレイピングも行いません。

仕組み

サーバーはhttpxを使ってポータルの公開Explore APIを呼び出し、クエリ自体（group_by tempo、sum(...)）で集計するため、地域別および全国の合計はサーバー側で計算されます。病院名はアクセント記号の有無を区別せずに照合されます。「Hospital de Faro」などの病院は、施設一覧を使って、報告先であるULS（「ULS do Algarve」）に対応付けられます。データセットカタログ、施設一覧、施設名はメモリ内に6時間キャッシュされます。上流への呼び出しに失敗した場合やクエリの形式が正しくない場合、ツールは明確な{"error": ...}を返し、推測は行いません。

環境変数による上書き（任意）：SNS_ODS_BASE_URL、SNS_INSTITUTIONS_URL。

ライセンス

MIT