seoul-uncomfort-report-mcp

MCP-сервер для запроса статуса отчетов о неудобствах по секторам в Сеуле, информации о количестве жалоб по районам Сеула и информации о количестве жалоб по годам/месяцам в Сеуле. Основан на открытом API Сеульской открытой площадки данных (data.seoul.go.kr).

Исходные наборы данных, интегрированные в этот MCP (Реестр наборов данных)

Эта таблица является «списком конфигурации» данного MCP. Прежде чем добавлять новый набор данных или создавать новый MCP, сначала посмотрите на эту таблицу и примите решение — в левом столбце указаны названия точно так, как они отображаются на экране списка Сеульской открытой площадки данных (data.seoul.go.kr), поэтому вы можете сразу визуально сверить их, открыв экран. Таблица создана так, чтобы решение можно было принять по одной этой таблице, без необходимости заново открывать код API (SERVICE) или другие документы.

Если порядок на экране (по дате изменения) изменится, он может не совпадать с порядком в таблице, поэтому критерием решения всегда является совпадение двух столбцов: «название набора данных» + «предоставляющий отдел». Порядок можно игнорировать.

Как за 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 года, то для августадекабря значений нет).

Параметры: 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_KEY.

• Корректно работают все комбинации: все необязательные параметры YEAR/MONTH опущены, указан только YEAR, указаны и YEAR, и MONTH. У SmartUncomfStatMonth параметра MONTH вообще нет, поэтому он работает только с YEAR (подтверждено фактически).

• В ответе API структура JSON может различаться при одном результате и при нескольких (одиночный dict против list), поэтому на сервере результат всегда нормализуется в список.

• Числовые поля приходят из JSON как числа с плавающей точкой (например, 55567.0). Пустые теги ещё не наступивших месяцев (например, MON_08) приходят не как null, а как 0.0. Сервер безопасно преобразует всё в целые числа и возвращает.

• Этот сервер открыт без аутентификации по ключу API, применяется rate limit по IP (3 запроса в минуту, при 5 нарушениях в течение 1 часа — блокировка на 24 часа, всего 30 запросов за 24 часа — при мультимашинном развёртывании лимит может фактически смягчаться пропорционально количеству машин).

Лицензия

MIT