seoul-realtime-air-by-region-mcp

ソウル市の圏域別（都心圏/東北圏/東南圏/西北圏/西南圏）リアルタイム大気環境現況を照会するMCPサーバーです。 ソウル開放データ広場の RealtimeCityAir APIを基にしています。

• 提供機関/部署: ソウル特別市気候環境本部大気政策課

• 元データ: ソウル開放データ広場 — ソウル市圏域別リアルタイム大気環境現況

• ライセンス（データ）: 公共ヌリ1類型（出典表示、商業利用及び変更可能）

• ライセンス（コード）: MIT

提供ツール

get_realtime_air_by_region

圏域別（または特定圏域/測定所）リアルタイム大気環境現況を照会します。

返却フィールド: 測定日時(MSRMT_DT)、圏域(SAREA_NM)、測定所(MSRSTN_NM)、微細粉塵(PM, ㎍/㎥)、 超微細粉塵(FPM, ㎍/㎥)、オゾン(OZON, ppm)、二酸化窒素(NTDX, ppm)、一酸化炭素(CBMX, ppm)、 二酸化硫黄(SPDX, ppm)、統合大気環境等級(CAI_GRD)、統合大気環境指数(CAI_IDX)、指数決定物質(CRST_SBSTN)

list_available_regions

照会可能な圏域名5つ（都心圏/東北圏/東南圏/西北圏/西南圏）の固定リストを返却します。API呼び出しなし。

Related MCP server: mcp-waqi

実測で確認された制約事項

• 認証キーはURLパスセグメントで渡します（/{KEY}/json/RealtimeCityAir/...）、クエリパラメータではありません。

• msrstn_nmはsarea_nmなしで単独使用できません。 APIパス構造上、選択パラメータは SAREA_NMの位置 → MSRSTN_NMの位置の順に固定されており、sarea_nmを省略してmsrstn_nmのみ 渡すと、その値がSAREA_NMの位置として解釈され、INFO-200（データなし）が返却されます。このサーバーは msrstn_nmのみ指定されたリクエストをAPI呼び出し前にフィルタリングし、明確なエラーとして案内します。

• start_index/end_index範囲を広げると実際に複数件が正常に返却されます（全体照会時25件確認）。

• 正常応答はJSONですが、認証キーエラー(INFO-100)など一部のエラー応答はTYPE=jsonリクエストでもXMLで 返却されます。 このサーバーはJSONパース失敗時にXML <CODE>/<MESSAGE>を抽出するフォールバックパーサーを使用します。

• CAI_GRD（統合大気環境等級）値は実測時点基準で「良い」、「普通」が確認されました（「悪い」/「非常に悪い」は 実測時点で観測されていませんが、仕様上存在する可能性があります）。

インストール及び実行（ローカル）

git clone https://github.com/hlucent/seoul-realtime-air-by-region-mcp.git
cd seoul-realtime-air-by-region-mcp
pip install -r requirements.txt
cp .env.example .env  # SEOUL_API_KEY 값 입력
python server.py

環境変数

配布（fly.io）

fly launch --no-deploy
fly secrets set SEOUL_API_KEY=<발급받은키>
flyctl deploy

配布後、Claude.aiコネクタ接続時に以下の形式で/mcpパスを付けて登録します:

https://<앱이름>.fly.dev/mcp

セキュリティ

認証キーなしで公開されるサーバーで、IPベースの3段階レート制限が適用されています （分間3回 — マルチマシン配布時はマシン数に比例して実質緩和される可能性あり、時間5回違反時 24時間ブロック、日30回総量制限）。

IPはFly-Client-IPヘッダー（fly.ioエッジが直接設定、クライアント偽装不可）を優先使用します。 レート制限カウンターはインメモリ（dict）でプロセスごとに保持され、マシン間で共有されないため、 fly.ioがリクエストを複数マシンに分散する場合、同一IP基準の実質制限が「分間3回 × 実行中の マシン数」に緩和される可能性があります。これは外部ストレージなしでin-memoryで実装するという設計上の トレードオフです。

ライセンス

MIT License. 元データは公共ヌリ1類型に従います。