seoul-uncomfort-report-mcp

首尔市智能不便举报分类别举报现状、首尔市按位置的不便举报件数信息、 首尔市按年度/月度不便举报件数信息查询 MCP 服务器。 基于首尔开放数据广场(data.seoul.go.kr)开放API。

此 MCP 集成的原始数据集（Dataset Registry）

此表就是此 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年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_KEY 正常工作。

• 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