Aqicn MCP

🚀 AQICN MCP サーバー

これはモデルコンテキストプロトコル（MCP）サーバーで、世界の空気質指数（AQICN）プロジェクトからの都市の空気質管理ツールを提供します。このサーバーを使用すると、大規模言語モデル（LLMs）が世界中の都市や座標位置の空気質データをリアルタイムで取得できます。

📦 インストール

Smithery を通じたインストール

Claude Desktop で AQICN MCP サーバーを自動的にインストールするには、Smithery にアクセスしてください。

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

uv を使用した手動インストール（推奨）

Python 環境の管理には uv の使用を推奨します。

# パッケージと依存関係のインストール
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 チェックツールを使用して、迅速にテストおよびデバッグを行います。

mcp dev aqicn_server.py

Claude Desktop への統合

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

mcp install aqicn_server.py

直接起動

テストまたはカスタムデプロイに使用します。

python aqicn_server.py

💻 使用例

基本的な使用法

# 北京市の空気質を取得
result = city_aqi("北京")

# 座標を指定して空気質を取得
result = geo_aqi(39.9042, 116.5591)

# すべての空気質監視局を検索
stations = search_station("北京")

📚 詳細ドキュメント

利用可能なツール

1. city_aqi

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

@mcp.tool()
def city_aqi(city: str) -> AQIData:
    """特定の都市の空気質データを取得します。"""

入力:

• city: 検索する都市名

出力: 以下の情報を含む AQIData:

• aqi: 空気質指数の値
• station: 監視局の名前
• dominant_pollutant: 主要な汚染物質（ある場合）
• time: 測定のタイムスタンプ
• coordinates: 監視局の緯度と経度

2. geo_aqi

座標に基づいて特定の位置の空気質データを取得します。

@mcp.tool()
def geo_aqi(latitude: float, longitude: float) -> AQIData:
    """座標に基づいて特定の位置の空気質データを取得します。"""

入力:

• latitude: 緯度の値
• longitude: 経度の値

出力: city_aqi と同じ

3. search_station

キーワードを使用して空気質監視局を検索します。

@mcp.tool()
def search_station(keyword: str) -> list[StationInfo]:
    """キーワードに基づいて空気質監視局を検索します。"""

入力:

• keyword: 検索キーワード（都市名、局名など）

出力: 以下の情報を含む StationInfo のリスト:

• name: 局名
• station_id: 一意の局 ID
• coordinates: 局の緯度と経度

⚠️ 注意事項

• インストールする前に、AQICN プラットフォームから有効な API Key を取得してください。
• 何か問題がある場合は、GitHub のドキュメントを参照するか、issue を提出してください。

AQICN MCP サーバーをご利用いただき、ありがとうございます！