China Air Quality

@pipeworx/china-air-quality

中国全土のリアルタイム大気質（空气质量）情報 — AQI、汚染物質レベルと濃度（PM2.5、PM10、O3、NO2、SO2、CO）、大気質評価、測定局の詳細を取得できます。キーは不要です。

Pipeworx の一部です。AI エージェントを1875以上のライブデータソースに接続する MCP ゲートウェイです。これは独立した非公式の連携であり、上流プロバイダーとの提携、承認、公開はありません。

2026-09-07に調査した中国政府系の20の情報源（docs/china-vertical-plan.md §2）のうち、セッション Cookie、Referer の細工、非公開のカタログ ID を使わずに、整った JSON を返したのはこれだけでした。直近30日間に外部からの需要はありませんでした。これは、問い合わせへの対応ではなく、独自性があるために構築されました（CNEMC を MCP 経由で提供するものは他にありません）。

ツール

• china_air_quality(city) — 都市の現在の AQI、大気質評価、主要な汚染物質、汚染物質ごとの指数レベル、測定局の平均濃度を取得します。英語の都市名（「Beijing」）、省名（「Guangdong」は省都の Guangzhou に解決）、または中国語名（「北京市」）を指定できます。
• china_air_quality_ranking(direction?, n?, pollutant?) — AQI または特定の汚染物質の指数レベルによる、CNEMC が監視する全国338都市のランキングです。direction: "bottom"（デフォルト）では最も汚染された都市を、"top" では最も空気がきれいな都市を表示します。
• china_air_quality_stations(city) — 1都市にある個々の測定局すべてについて、それぞれの AQI、濃度、座標を取得します。都市全体の平均が表す地域レベルの情報を確認できます。

データソース

中国国家環境監測センター（中国环境监测总站）は、中国の公式大気質監視ネットワークを運営する政府機関です。

• https://air.cnemc.cn:18007/CityData/GetAllCityRealTimeAQIModels — 338都市すべての情報を1時間ごとに更新します。AQI と、各汚染物質の1～6の指数レベルを含みますが、生の濃度は含みません。
• https://air.cnemc.cn:18007/CityData/GetAQIDataPublishLive?cityName=<市名> — 1都市の測定局単位のデータ行を返し、汚染物質の実濃度（µg/m³、CO は mg/m³）を含みます。GetAQIDataPublishLives（複数形）は無効なパスで、404を返します。

china_air_quality は2つの呼び出しを統合します。キャッシュされた全都市フィードから都市レベルの AQI、レベル、大気質を取得し、当該都市の測定局データから平均濃度を計算します。これは、全都市エンドポイントだけでは濃度値を取得できないためです。

全都市のペイロード（144 KB、1時間ごとに更新）は、プロセス内で10分間キャッシュされます。

都市名 — 上流では中国語名のみ

CNEMC は各都市を中国語の行政区画名で識別します。上流では「Beijing」では検索できません。src/index.ts には、生成された次のテーブルが含まれています。

• CITY_EN_TO_ZH — 公表されている338の都市名すべてについて、漢語拼音をローマ字表記したもの（行政区画の接尾辞である 市／州／盟／地区／自治州 を削除）。一般的な英語表記がそのままの拼音と異なる少数の都市については、個別に上書きしています：Xi'an、Harbin、Urumqi、Lhasa、Hohhot、Ordos、Qiqihar、Hulunbuir。
• PROVINCE_TO_ZH — 31の省・自治区・直轄市について、英語名と中国語名を省都に対応付けています。そのため、「air quality in Guangdong」は Guangzhou に解決されます。
• 中国語の入力は、公表されている338の都市名に対して、末尾の 市／州 の有無を問わず、そのまま受け付けられます。

解決できない都市名に対しては、上流のエラーではなく、ヒントを添えて found: false を返します。CNEMC 自体は不明な都市に対して何も返さず空の配列を返すため、そのままでは「都市が認識されない」ではなく「汚染データがない」と受け取られてしまいます。

既知の制限

• 濃度は単一の公式値ではなく、観測所の平均値です。 CNEMC が公開する濃度は観測所単位のみです。市レベルの概要は、現在の時間帯におけるその市の報告対象観測所の平均値であり、各レスポンスの pollutant_note に記載されています。
• センサーの検出下限を下回る濃度は、推測せずに除外します。 CNEMC は 一部の測定値を <3（検出限界未満）として報告します。誤った数値として解析するのではなく、平均値から除外します。
• MEE の月次市レポートは HTML であり、このパックの対象外です。詳しくは docs/china-vertical-plan.md §2 をご覧ください（別途、調査タスクとして登録されています）。

認証

不要です。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します。

{
  "mcpServers": {
    "china-air-quality": {
      "url": "https://gateway.pipeworx.io/china-air-quality/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/china-air-quality/mcp の tools/list は、上記の表にあるツールに加えて、共有の Pipeworx メタツール（ask_pipeworx、 discover_tools、search_within、remember／recall など、ゲートウェイ全体で使えるツール一式）も返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、パック固有のツールとともに、およそ 30 個の共有ツールが一覧表示されます。接続の initialize レスポンスには正確な対象範囲が記載されており、その日の状況を確認するうえで最も信頼できる情報です。

これは意図的な設計であり、偶然の多重化ではありません。メタツールを使うことで、このパックでは対応していない質問にも、カタログ全体を対象にルーティングする ask_pipeworx を通じて回答できます。そのため、MCP サーバーをもう 1 つ追加する必要はありません。現在、メタツールなしでパックのエンドポイントを接続する方法はありません。追加のスキーマがルーティングの利点よりもコンテキストを多く消費する場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度接続してください。

または、Pipeworx のフルゲートウェイに接続すると、このパックだけでなく、すべてのパックのツールが直接一覧表示されます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も、同じゲートウェイと同じ 1875+ 個のデータソースに接続します。唯一の違いは、どのパックのツールが直接一覧表示されるかです。どちらからでも、ask_pipeworx を使ってすべてのツールにアクセスできます。

MCP クライアントがない場合：HTTP 経由で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/china_air_quality \
  -H 'Content-Type: application/json' \
  -d '{"city":"Beijing"}'

最初の呼び出しにアカウントは不要です。ツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/china_air_quality を使用します。ツールを検索するには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を使用します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントは不要で、ゲートウェイへの往復通信もありません。

{
  "mcpServers": {
    "china-air-quality": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-china-air-quality"]
    }
  }
}

または、直接実行して起動を確認します。

npx -y @pipeworx/mcp-china-air-quality

stdin/stdout 経由で MCP を扱い、このパック固有のツールのみを対象に initialize／tools/list／tools/call に応答します。上記のゲートウェイ接続で追加される共有メタツールはありません。同じソース、同じツールを利用でき、ask_pipeworx によるルーティングはありません。

ask_pipeworx の使用

ツールを直接呼び出す代わりに、平易な英語で質問できます。これは上記のパックエンドポイントでも、フルゲートウェイでも利用できます。

ask_pipeworx({ question: "your question about China Air Quality data" })

ゲートウェイが適切なツールを選び、引数を自動的に設定します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT