Aqicn MCP

🚀 AQICN MCP 服務器

這是一個模型上下文協議（MCP）服務器，提供來自世界空氣質量指數（AQICN）項目的城市空氣質量管理工具。它允許大型語言模型（LLMs）即時獲取全球城市和座標位置的空氣質量數據。

🚀 快速開始

AQICN MCP 服務器可助力大型語言模型即時獲取全球城市和座標位置的空氣質量數據。下面為你詳細介紹其安裝、配置和運行的步驟。

📦 安裝指南

通過 Smithery 安裝

要自動安裝 AQICN MCP 服務器以供 Claude Desktop 使用，請訪問 Smithery：

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

推薦使用 uv 手動安裝

我們推薦使用 uv 來管理 Python 環境：

# 安裝包及依賴項
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

✨ 主要特性

本服務器提供了以下幾個實用工具，可用於獲取空氣質量數據和搜索監測站：

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：站點經緯度

💻 使用示例

基礎用法

# 查詢北京市空氣質量
result = city_aqi("北京")

# 根據座標查詢某地的空氣質量
result = geo_aqi(39.9042, 116.5591)

# 搜索所有空氣質量監測站
stations = search_station("北京")

⚠️ 注意事項

⚠️ 重要提示

安裝前請確保已獲取 AQICN 平臺的有效 API Key。

💡 使用建議

如有任何問題，請訪問 GitHub 查看文檔或提交 issue。

感謝使用 AQICN MCP 服務器！