airkorea-statistics-mcp

提供将한국환경공단이运行的 Air Korea(Korea) 导致污染统计服务(ArpltnStatsSvc) OpenAPI 作为 Claude 可使用的 MCP(Model Context Protocol) 服务器的包。可查询按시 도별/시군구별的实时平均信息，以及按测量站별 일/月 평균 통계。

에어코리아 Air Korea 三阶段分离开发 중 마지막 단계이며，与 1단계(airkorea-realtime-mcp)、2단계(airkorea-forecast-alert-mcp) 함께 사용하는 것을 기본 조건으로 합니다。

제공 기능

测量单位：SO2/CO/O3/NO2 = ppm、PM10/PM2.5 = ㎍/㎥

关于本 MCP 的范围（重要）

仅包含属于大气污染统计服务(ArpltnStatsSvc)的 4 个操作。以下 2 个操作原本是第 3 阶段候选（실상 3단계后补），但由于实际上属于其他服务组，因此未纳入本次范围（判断依据参考 DEVPLAN.md 0-1 节，决定经过参考 DEVLOG.md）：

• getTMStdrCrdnt(TM 标准坐标查询) — 属于측measurement所在信息查询服务(MrsтnInfoInqireSvc)，并与 1 阶段(airkorea-realtime-mcp) 같은 서비스 그룹

• getUnityAirEnvrnIdexSnstiveAboveMsrstnList(통합대大气环境指数 이상 이상测量的测量所목록조회) — 属于大气污染信息查询服务(=79), 与 1、2 阶段의 같은服务组

及以上两个操作是否加入 1、2 阶段的 저장仓库，将另行讨论（暂缓）。

安装及执行

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

环境变量

注意：要调用此 MCP，必须在 data.go.kr 등록하고 있어야 합니다. 진행을 위해 별도의 "大气污染统计 service" 활용申请이 필요하며(서비스 ID 단위 기별 신청), 注册 후 적용하기까지 1~2 시간 소요됩니다.

部署 (fly.io)

fly launch --no-deploy
fly secrets set AIRKOREA_SERVICE_KEY=발급받은키
flyctl deploy

部署 후 커넥터 链接地址:

https://airkorea-statistics-mcp.fly.dev/mcp

Rate Limit

이 MCP는 무인증 접근 가능한 공개服务器，因此基于 IP 实施三层 Rate Limit：

• 每分钟超过 3회 시 반환할 429

• 指派 1시간 내 5회 위반 指 24시 간 차단

• 를 하루 (rolling 24h) 之内 총 30회 超过 시的 _ 429

多机部署时，内存计数器按机器各自分开，实际限制会并按机器数量成比例放松。

已知의 제약 사항（已实测确认，2026-08-23）

• 数字字段以 JSON 字符串形式，在代码中安全转换为 float. 缺失 expression已确认为 空 문자열(""), 而 not "-" (于 khaiValue, pm10Value 等中观察到)。

• 已确认 getCtprvnMesureSidoLIst 响应中实际包含 khaiValue 字段。

• Solo 传 sidoName=광주 时节 totalCount=0 (데이터 없음) — 这两个区域必须通过 병합한 전남광주 查询才能 returns 正常 data (which is different from the 규정문).

• 错误响应 누적 범위(코드 30, 10) 내에서 정상적으로 JSON 返回。虽 falls back 函数 (XML fallback) 已实现，但未复现。(若未来发现 XML 返回的情况，将在 DEVLOG.md 中追加记录。)

• SERVICETIMEOUT(504) 未能在本地复现——虽已实现重试逻辑(最多 3 次)，但实际操作中未检测 situation。

数据 출처

• 提供机关：한국환경공공단 (환경부 위탁 기관)

• 平台: 公共数据 portal (data.go.kr)

• API名称: 한국환경공단_에어코리아_大气污染统计具体情况 (ArpltnStatsSvc)

• 라이선스: 공공누리 공공 제 1 유형 (저작자표시–변경禁止)

라이선스

MIT License (코드 코드 자체). 原始数据应遵守上述 public domain license。