AQICN MCP サーバー

これは、世界大気質指標（AQICN）プロジェクトの大気質データツールを提供するモデルコンテキストプロトコル（MCP）サーバーです。これにより、LLMは世界中の都市と座標のリアルタイム大気質データを取得できます。

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop 用の AQICN MCP Server を自動的にインストールするには:

npx -y @smithery/cli install @mattmarcin/aqicn-mcp --client claude

推奨UV（手動）によるインストール

Python 環境を管理するには、 uvを使用することをお勧めします。

# Install the package and dependencies
uv pip install -e .

環境設定

プロジェクトルートに.envファイルを作成します ( .env.exampleからコピーできます)。

# .env
AQICN_API_KEY=your_api_key_here

あるいは、環境変数を直接設定することもできます。

# Linux/macOS
export AQICN_API_KEY=your_api_key_here

# Windows
set AQICN_API_KEY=your_api_key_here

サーバーの実行

開発モード

サーバーをテストおよびデバッグする最も速い方法は、MCP Inspector を使用することです。

mcp dev aqicn_server.py

クロードデスクトップ統合

サーバーの準備ができたら、Claude Desktop にインストールします。

mcp install aqicn_server.py

直接実行

テストまたはカスタム展開の場合:

python aqicn_server.py

利用可能なツール

1. シティアキ

特定の都市の空気質データを取得します。

@mcp.tool()
def city_aqi(city: str) -> AQIData:
    """Get air quality data for a specific city."""

入力：

city : 空気質データを取得する都市の名前

出力: AQIDataと次の内容:

aqi ：大気質指数値
station ：駅名
dominant_pollutant : 主な汚染物質（存在する場合）
time : 測定のタイムスタンプ
coordinates ：駅の緯度と経度

2. geo_aqi

座標を使用して特定の場所の空気質データを取得します。

@mcp.tool()
def geo_aqi(latitude: float, longitude: float) -> AQIData:
    """Get air quality data for a specific location using coordinates."""

入力：

latitude : 場所の緯度
longitude : 場所の経度

出力: city_aqiと同じ

3. 検索ステーション

キーワードで空気質監視ステーションを検索します。

@mcp.tool()
def search_station(keyword: str) -> list[StationInfo]:
    """Search for air quality monitoring stations by keyword."""

入力：

keyword ：駅を検索するためのキーワード（都市名、駅名など）

**出力:**次の内容を含むStationInfoのリスト:

name ：駅名
station_id : 一意の駅識別子
coordinates ：駅の緯度と経度

使用例

MCP Python クライアントの使用:

from mcp import Client

async with Client() as client:
    # Get air quality data for Beijing
    beijing_data = await client.city_aqi(city="beijing")
    print(f"Beijing AQI: {beijing_data.aqi}")

    # Get air quality data by coordinates (Tokyo)
    geo_data = await client.geo_aqi(latitude=35.6762, longitude=139.6503)
    print(f"Tokyo AQI: {geo_data.aqi}")

    # Search for stations
    stations = await client.search_station(keyword="london")
    for station in stations:
        print(f"Station: {station.name} ({station.coordinates})")

貢献

お気軽に問題提起やプルリクエストを行ってください。変更には適切なテストとドキュメントが含まれていることをご確認ください。

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています。

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

モデルコンテキストプロトコル (MCP) を介して、世界大気質指数とのやり取りを可能にし、世界中の都市と座標のリアルタイムの大気質データを取得します。

Related Resources

Reddit Discussion about this server

Related MCP Servers

WeatherAPI MCP Server
swonixs
-
security
F
license
-
quality
Provides current weather and air quality data for any city using WeatherAPI, easily integrating with MCP clients like n8n and Claude Desktop App.
Last updated -
53
1
Weather MCP Tool
jalaj-pandey
-
security
F
license
-
quality
An India-focused MCP server that provides real-time weather conditions, forecasts, air quality data, and location search capabilities using the OpenWeatherMap API.
Last updated -
AirNow MCP Server
prsantos-com
A
security
A
license
A
quality
A Model Context Protocol implementation that enables LLMs to access real-time, forecasted, and historical U.S. air quality data through the AirNow API.
Last updated -
10
3
MIT License
Said MCP
JunLovin
A
security
F
license
A
quality
A MCP server that provides real-time weather information for any city through a simple tool that resolves geographic coordinates and fetches current weather data.
Last updated -
1
11

View all related MCP servers

AQICN MCP Server