seoul-uncomfort-report-mcp

서울시 스마트 불편신고 분야별 신고 현황、서울시 위치별 불편신고건수 정보、 서울시 년도별/월별 불편신고건수 정보を照会するMCPサーバーです。 서울열린데이터광장(data.seoul.go.kr)のオープンAPIに基づいています。

このMCPに統合された元データセット (Dataset Registry)

この表がこのMCPの「構成リスト」です。 新しいデータセットを追加したり、新しいMCPを作成する前に まずこの表を見て判断してください — 左の列は서울열린데이터광장(data.seoul.go.kr)のリスト 画面で実際に表示される名前そのままなので、画面を開いて目で直接照合できます。 APIコード名(SERVICE)や他のドキュメントを再度開く必要なく、この表だけで判断が終わるように 作ったものです。

画面リストの順序(修正日時順)が変わると表の順序と合わないことがあるので、判断基準は常に 「データセット名」+「提供部署」の2列の一致有無です。順序は無視して構いません。

新しいデータセットを見たとき、この表だけで3秒以内に判断する方法

1. 画面上のデータセット名が上記の表の左の列にすでにある → 何もしなくてよい (重複)

2. 画面上のデータセット名は初めて見るが、提供部署が「디지털도시국 공간정보과」であり 説明に「서울시 스마트 불편신고」が含まれる → このMCPにツール追加の検討対象。

3. 提供部署が異なる (例: 「보도상영업시설물」、「노동조합」など他の部署が提供するデータセット) → このMCPとは無関係。完全に新しいMCPプロジェクトとして進める。

この判断にAPI呼び出しやClaudeへの再質問が不要なように、この表は画面キャプチャの名称をそのまま 使って、人が直接照合できるように作ったものです。

Related MCP server: sbinfo

提供ツール

1. get_uncomfort_report_by_sector

分野別(交通、道路、清掃、住宅建築、治水防災、街路整備、保健、公園緑地、環境、経済/産業、 消防安全、その他不便事項)の不便申告件数を照会します。単位: 件数。

パラメータ: year(選択)、month(選択)、start_index(基本 1)、end_index(基本 20)

2. get_uncomfort_report_by_district

ソウル市25の自治区+他市道基準の不便申告件数を照会します。単位: 件数。

パラメータ: year(選択)、month(選択)、start_index(基本 1)、end_index(基本 20)

3. get_uncomfort_report_by_month

年度別112月の不便申告件数と年間合計を照会します。単位: 件数。 注意: このサービスには月(MONTH)パラメータがありません — 年度全体のデータのみ照会可能です。 まだ経過していない月はデータが空です(例: 照会時点が2026年7月の場合、812月は値なし)。

パラメータ: year(選択)、start_index(基本 1)、end_index(基本 20)

インストールおよび実行 (ローカル)

pip install -r requirements.txt
cp .env.example .env  # SEOUL_API_KEY 입력
python server.py

環境変数

デプロイ

fly.ioのデプロイ方式はCLAUDE.md、プロジェクト共通の指針に従います。 デプロイ完了後、Claude.aiコネクタ接続時にURLの末尾に/mcpを付ける必要があります。 例: https://seoul-uncomfort-report-mcp.fly.dev/mcp

データ出所およびライセンス

• 提供機関: ソウル特別市

• 提供部署: 디지털도시국 공간정보과

• 原本システム: 서울시 스마트 불편신고

• 利用許諾範囲: 공공누리 1類型 (出所表示、商業的利用および変更可能)

既知の制約事項 (実測確認済み)

• 認証キーはURLパスセグメント方式(/{KEY}/json/{SERVICE}/...)で渡すと正常に 動作します。クエリパラメータ方式は別途試していません(パス方式が最初の試行で成功)。

• 3つのサービス(SmartUncomfStatSector、SmartUncomfStatLocale、SmartUncomfStatMonth) すべて同じSEOUL_API_KEY1つで正常に動作することを実測確認しました。

• YEAR/MONTH選択パラメータはすべて省略、YEARのみ指定、YEAR+MONTH両方指定の組み合わせすべて 正常に動作します。SmartUncomfStatMonthはMONTHパラメータ自体がないため、YEAR単独でのみ 動作します(実測確認)。

• APIレスポンスで結果が1件の場合と複数件の場合でJSON構造が異なることがあるため(単一dict vs list) サーバー内部で常にリストに正規化します。

• 数値フィールドはJSONで実数(例: 55567.0)で返ってきます。まだ経過していない月の空タグ(例: MON_08)はnullではなく0.0で返ってきます。サーバーで全て整数に安全変換して返します。

• このサーバーはAPIキー認証なしで公開され、IP基準のrate limitが適用されます (毎分3回、1時間以内に5回違反すると24時間ブロック、24時間合計30回 — マルチマシンデプロイ時は マシン数に比例して実質緩和される可能性があります)。

ライセンス

MIT