seoul-realtime-air-by-region-mcp

这是一个MCP服务器，用于查询首尔市各区域（市中心圈/东北圈/东南圈/西北圈/西南圈）的实时大气环境状况。基于首尔开放数据广场的 RealtimeCityAir API。

• 提供机构/部门: 首尔特别市气候环境本部大气政策科

• 原始数据: 首尔开放数据广场 — 首尔市各区域实时大气环境状况

• 许可证(数据): 公共许可第1类（注明出处，允许商业使用和修改）

• 许可证(代码): MIT

提供的工具

get_realtime_air_by_region

查询各区域（或特定区域/监测站）的实时大气环境状况。

返回字段：测量日期时间(MSRMT_DT)、区域(SAREA_NM)、监测站(MSRSTN_NM)、细颗粒物(PM, ㎍/㎥)、超细颗粒物(FPM, ㎍/㎥)、臭氧(OZON, ppm)、二氧化氮(NTDX, ppm)、一氧化碳(CBMX, ppm)、二氧化硫(SPDX, ppm)、综合大气环境等级(CAI_GRD)、综合大气环境指数(CAI_IDX)、指数决定物质(CRST_SBSTN)

list_available_regions

返回可查询的5个区域名称（市中心圈/东北圈/东南圈/西北圈/西南圈）的固定列表。不调用API。

Related MCP server: mcp-waqi

实测确认的限制事项

• 认证密钥通过URL路径段传递（/{KEY}/json/RealtimeCityAir/...），而非查询参数。

• msrstn_nm不能在没有sarea_nm的情况下单独使用。 由于API路径结构，可选参数按SAREA_NM位置→MSRSTN_NM位置的顺序固定，如果省略sarea_nm而只传递msrstn_nm，则该值会被解释为SAREA_NM位置，返回INFO-200（无数据）。本服务器会在API调用前过滤掉仅指定了msrstn_nm的请求，并给出明确的错误提示。

• 扩大start_index/end_index范围后，实际会正常返回多条记录（全部查询时确认有25条）。

• 正常响应为JSON，但部分错误响应（如认证密钥错误INFO-100）即使在TYPE=json请求下也会返回XML。 本服务器在JSON解析失败时会使用回退解析器提取XML的<CODE>/<MESSAGE>。

• CAI_GRD（综合大气环境等级）值在实测时点确认为“良好”、“普通”（“差”/“非常差”在实测时点未观测到，但根据规范可能存在）。

安装与运行（本地）

git clone https://github.com/hlucent/seoul-realtime-air-by-region-mcp.git
cd seoul-realtime-air-by-region-mcp
pip install -r requirements.txt
cp .env.example .env  # SEOUL_API_KEY 값 입력
python server.py

环境变量

部署（fly.io）

fly launch --no-deploy
fly secrets set SEOUL_API_KEY=<발급받은키>
flyctl deploy

部署后，在Claude.ai连接器连接时，按以下形式添加/mcp路径进行注册：

https://<앱이름>.fly.dev/mcp

安全

这是一个无需认证密钥即可公开访问的服务器，应用了基于IP的三级速率限制（每分钟3次——多机部署时可能按机器数量比例实际放宽，每小时违反5次则封禁24小时，每日总限制30次）。

IP优先使用Fly-Client-IP标头（由fly.io边缘直接设置，客户端无法伪造）。速率限制计数器以内存（dict）方式按进程维护，不跨机器共享，因此当fly.io将请求分发到多台机器时，同一IP的实际限制可能会放宽为“每分钟3次 × 运行中的机器数量”。这是在没有外部存储的情况下采用内存实现的设计权衡。

许可证

MIT许可证。原始数据遵循公共许可第1类。