seoul-uncomfort-report-mcp

MCP-Server zum Abrufen von 서울시 스마트 불편신고 분야별 신고 현황, 서울시 위치별 불편신고건수 정보 und 서울시 년도별/월별 불편신고건수 정보. Basiert auf der OpenAPI von 서울열린데이터광장 (data.seoul.go.kr).

In dieses MCP integrierte Original-Datensätze (Dataset Registry)

Diese Tabelle ist die „Konfigurationsliste" dieses MCP. Bevor Sie einen neuen Datensatz hinzufügen oder ein neues MCP erstellen, prüfen Sie zuerst diese Tabelle — die linke Spalte entspricht exakt den Namen, die auf der Listenseite von 서울열린데이터광장 (data.seoul.go.kr) tatsächlich angezeigt werden, sodass Sie sie direkt mit dem geöffneten Bildschirm abgleichen können. Sie wurde so erstellt, dass die Entscheidung allein anhand dieser Tabelle getroffen werden kann, ohne die API-Codenamen (SERVICE) oder andere Dokumente erneut öffnen zu müssen.

Wenn sich die Reihenfolge der Bildschirmliste (nach Änderungsdatum) ändert, kann die Tabellenreihenfolge abweichen. Entscheidend ist daher immer die Übereinstimmung der beiden Spalten „Datensatzname" + „Bereitstellende Abteilung". Die Reihenfolge kann ignoriert werden.

So entscheiden Sie in 3 Sekunden nur anhand dieser Tabelle, wenn Sie einen neuen Datensatz sehen

1. Der Datensatzname auf dem Bildschirm steht bereits in der linken Spalte der obigen Tabelle → Es ist nichts zu tun (Duplikat)

2. Der Datensatzname ist neu auf dem Bildschirm, aber die bereitstellende Abteilung ist „디지털도시국 공간정보과" und die Beschreibung enthält „서울시 스마트 불편신고" → Kandidat für die Hinzufügung eines Tools zu diesem MCP.

3. Die bereitstellende Abteilung ist anders (z. B. Datensätze anderer Abteilungen wie „보도상영업시설물", „노동조합" usw.) → Kein Bezug zu diesem MCP. Als völlig neues MCP-Projekt fortfahren.

Damit für diese Entscheidung keine API-Aufrufe oder Rückfragen an Claude erforderlich sind, wurde diese Tabelle mit den exakten Bildschirmbezeichnungen erstellt, sodass ein direkter manueller Abgleich möglich ist.

Related MCP server: sbinfo

Bereitgestellte Tools

1. get_uncomfort_report_by_sector

Ruft die Anzahl der Unannehmlichkeitsmeldungen nach Kategorie ab (Verkehr, Straßen, Reinigung, Wohnungsbau, Hochwasserschutz/Katastrophenschutz, Straßeninstandhaltung, Gesundheit, Parks/Grünflächen, Umwelt, Wirtschaft/Industrie, Brandschutz, sonstige Unannehmlichkeiten). Einheit: Anzahl.

Parameter: year (optional), month (optional), start_index (Standard 1), end_index (Standard 20)

2. get_uncomfort_report_by_district

Ruft die Anzahl der Unannehmlichkeitsmeldungen für die 25 Bezirke von Seoul + andere Städte/Provinzen ab. Einheit: Anzahl.

Parameter: year (optional), month (optional), start_index (Standard 1), end_index (Standard 20)

3. get_uncomfort_report_by_month

Ruft die Anzahl der Unannehmlichkeitsmeldungen pro Jahr für Januar bis Dezember sowie die Jahressumme ab. Einheit: Anzahl. Hinweis: Dieser Dienst hat keinen Monatsparameter (MONTH) — es können nur Daten für das gesamte Jahr abgerufen werden. Monate, die noch nicht vergangen sind, enthalten keine Daten (z. B. wenn der Abrufzeitpunkt Juli 2026 ist, haben August bis Dezember keine Werte).

Parameter: year (optional), start_index (Standard 1), end_index (Standard 20)

Installation und Ausführung (lokal)

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

Umgebungsvariablen

Bereitstellung

Die Bereitstellung auf fly.io folgt CLAUDE.md und den gemeinsamen Projektrichtlinien. Nach Abschluss der Bereitstellung muss beim Verbinden mit dem Claude.ai-Connector /mcp an das URL-Ende angehängt werden. Beispiel: https://seoul-uncomfort-report-mcp.fly.dev/mcp

Datenquelle und Lizenz

• Bereitstellende Organisation: 서울특별시

• Bereitstellende Abteilung: 디지털도시국 공간정보과

• Ursprungssystem: 서울시 스마트 불편신고

• Nutzungslizenz: 공공누리 Typ 1 (Namensnennung, kommerzielle Nutzung und Änderung erlaubt)

Bekannte Einschränkungen (durch Messungen bestätigt)

• Der Authentifizierungsschlüssel funktioniert korrekt, wenn er über URL-Pfadsegmente (/{KEY}/json/{SERVICE}/...) übergeben wird. Die Query-Parameter-Methode wurde nicht separat getestet (die Pfadmethode war beim ersten Versuch erfolgreich).

• Es wurde durch Messungen bestätigt, dass alle drei Dienste (SmartUncomfStatSector, SmartUncomfStatLocale, SmartUncomfStatMonth) mit demselben einzelnen SEOUL_API_KEY korrekt funktionieren.

• Die optionalen Parameter YEAR/MONTH funktionieren in allen Kombinationen korrekt: alle weggelassen, nur YEAR angegeben, YEAR+MONTH beide angegeben. SmartUncomfStatMonth hat keinen MONTH-Parameter und funktioniert daher nur mit YEAR allein (durch Messungen bestätigt).

• Da die JSON-Struktur in der API-Antwort bei einem einzelnen Ergebnis anders sein kann als bei mehreren Ergebnissen (einzelnes dict vs. list), wird im Server intern immer zu einer Liste normalisiert.

• Numerische Felder kommen im JSON als Gleitkommazahlen (z. B. 55567.0). Leere Tags für noch nicht vergangene Monate (z. B. MON_08) kommen nicht als null, sondern als 0.0. Der Server konvertiert alles sicher in Ganzzahlen und gibt sie zurück.

• Dieser Server ist ohne API-Key-Authentifizierung öffentlich zugänglich und unterliegt einem IP-basierten Rate-Limit (3 Anfragen pro Minute, 24 Stunden Sperre bei 5 Verstößen innerhalb einer Stunde, insgesamt 30 Anfragen in 24 Stunden — bei Multi-Machine-Bereitstellung kann sich dies proportional zur Anzahl der Maschinen faktisch lockern).

Lizenz

MIT