seoul-uncomfort-report-mcp

Servidor MCP que consulta el estado de reportes de inconvenientes inteligentes de Seúl por sector, la información del número de reportes de inconvenientes por ubicación en Seúl y la información del número de reportes de inconvenientes por año/mes en Seúl. Se basa en la API abierta de Seoul Open Data Plaza (data.seoul.go.kr).

Conjuntos de datos originales integrados en este MCP (Registro de conjuntos de datos)

Esta tabla es la "lista de configuración" de este MCP. Antes de añadir un nuevo conjunto de datos o crear un nuevo MCP, consulte primero esta tabla para decidir: la columna izquierda es exactamente el nombre que aparece en la pantalla de la lista de Seoul Open Data Plaza (data.seoul.go.kr), por lo que puede compararla directamente con la pantalla abierta. Está diseñada para que la decisión se complete con esta única tabla, sin necesidad de volver a consultar el nombre del código de la API (SERVICE) u otros documentos.

Si el orden de la lista en pantalla (por fecha de modificación) cambia, puede no coincidir con el orden de la tabla, por lo que el criterio de decisión es siempre la coincidencia de las dos columnas "nombre del conjunto de datos" + "departamento de asignación". El orden puede ignorarse.

Cómo decidir en 3 segundos con solo esta tabla al ver un nuevo conjunto de datos

1. Si el nombre del conjunto de datos en pantalla ya está en la columna izquierda de la tabla anterior → no hay que hacer nada (duplicado).

2. Si el nombre del conjunto de datos es nuevo en pantalla, pero el departamento de asignación es "디지털도시국 공간정보과" y la descripción contiene "서울시 스마트 불편신고" → es candidato a añadir una herramienta a este MCP.

3. Si el departamento de asignación es diferente (por ejemplo, conjuntos de datos proporcionados por otros departamentos como "보도상영업시설물", "노동조합", etc.) → no está relacionado con este MCP. Proceda como un proyecto MCP completamente nuevo.

Para que esta decisión no requiera llamadas a la API ni nuevas preguntas a Claude, esta tabla utiliza los nombres de captura de pantalla tal cual, de modo que una persona pueda compararla directamente.

Related MCP server: sbinfo

Herramientas proporcionadas

1. get_uncomfort_report_by_sector

Consulta el número de reportes de inconvenientes por categoría (transporte, carreteras, limpieza, construcción de viviendas, control de inundaciones, mantenimiento de calles, salud, parques y espacios verdes, medio ambiente, economía/industria, seguridad contra incendios, otros inconvenientes). Unidad: número de reportes.

Parámetros: year (opcional), month (opcional), start_index (por defecto 1), end_index (por defecto 20)

2. get_uncomfort_report_by_district

Consulta el número de reportes de inconvenientes para los 25 distritos autónomos de Seúl + otras ciudades. Unidad: número de reportes.

Parámetros: year (opcional), month (opcional), start_index (por defecto 1), end_index (por defecto 20)

3. get_uncomfort_report_by_month

Consulta el número de reportes de inconvenientes de enero a diciembre por año y el total anual. Unidad: número de reportes. Nota: este servicio no tiene el parámetro de mes (MONTH) — solo se pueden consultar los datos de todo el año. Los meses que aún no han pasado no tienen datos (por ejemplo, si la consulta se realiza en julio de 2026, los meses de agosto a diciembre no tienen valores).

Parámetros: year (opcional), start_index (por defecto 1), end_index (por defecto 20)

Instalación y ejecución (local)

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

Variables de entorno

Despliegue

El método de despliegue en fly.io sigue CLAUDE.md y las directrices comunes del proyecto. Tras completar el despliegue, al conectar el conector de Claude.ai, debe añadir /mcp al final de la URL. Ejemplo: https://seoul-uncomfort-report-mcp.fly.dev/mcp

Fuente de datos y licencia

• Organización proveedora: Gobierno Metropolitano de Seúl

• Departamento de asignación: 디지털도시국 공간정보과

• Sistema original: Sistema de reportes de inconvenientes inteligentes de Seúl

• Alcance de la licencia de uso: Tipo 1 de 공공누리 (indicación de la fuente, uso comercial y modificación permitidos)

Limitaciones conocidas (verificadas mediante medición real)

• La clave de autenticación funciona correctamente cuando se transmite mediante el método de segmento de ruta de URL (/{KEY}/json/{SERVICE}/...). No se ha probado el método de parámetro de consulta (el método de ruta tuvo éxito en el primer intento).

• Se ha verificado mediante medición que los 3 servicios (SmartUncomfStatSector, SmartUncomfStatLocale, SmartUncomfStatMonth) funcionan correctamente con una única SEOUL_API_KEY.

• Los parámetros opcionales YEAR/MONTH funcionan correctamente en todas las combinaciones: omitir todos, especificar solo YEAR, y especificar YEAR+MONTH. SmartUncomfStatMonth no tiene el parámetro MONTH, por lo que solo funciona con YEAR (verificado mediante medición).

• En la respuesta de la API, la estructura JSON puede diferir cuando el resultado es 1 caso y cuando son varios casos (dict único vs lista), por lo que el servidor siempre normaliza a una lista internamente.

• Los campos numéricos llegan como números de punto flotante (por ejemplo, 55567.0) en el JSON. Las etiquetas vacías de meses que aún no han pasado (por ejemplo, MON_08) llegan como 0.0, no como null. El servidor los convierte de forma segura a enteros y los devuelve.

• Este servidor está abierto sin autenticación de clave de API y se aplica un límite de velocidad basado en IP (3 veces por minuto, bloqueo de 24 horas si se supera 5 veces en 1 hora, 30 veces en total en 24 horas — en despliegues de múltiples máquinas, el límite puede aliviarse de forma efectiva en proporción al número de máquinas).

Licencia

MIT