google-air-quality-mcp - 集成Google API，提供空氣質量數據可視化及自然語言查詢的MCP工具

探索

Google Air Quality MCP

這是一個基於Google空氣質量API的MCP服務器，提供即時空氣質量數據、預報、歷史記錄和熱力圖可視化功能，支持通過自然語言查詢位置信息。

研究與數據位置服務 #空氣質量 #數據服務 #地理可視化 .Go

評分 : 2分

下載量 : 0

更新時間 : 2025-12-03

打開站點

什麼是Google Air Quality MCP Server?

這是一個專門為AI助手設計的空氣質量數據服務。它通過標準化的MCP協議，讓各種AI助手（如Claude、ChatGPT等）能夠輕鬆查詢全球任何地點的空氣質量信息，包括即時狀況、未來預報、歷史趨勢和可視化地圖。

如何使用Google Air Quality MCP Server?

使用非常簡單：1) 獲取Google空氣質量API密鑰；2) 啟動MCP服務器；3) 在AI助手中連接服務器；4) 使用自然語言查詢空氣質量。AI助手會自動將您的位置描述（如'北京天安門'）轉換為座標並獲取數據。

適用場景

適合旅行規劃、健康監測、環境研究、戶外活動安排等場景。無論是計劃出行前查看目的地空氣質量，還是監測居住區域的汙染水平，或是進行環境數據分析，這個服務都能提供準確、即時的信息支持。

主要功能

🌍 全球即時空氣質量

獲取全球任何地點的當前空氣質量指數(AQI)、主要汙染物濃度和健康建議，數據即時更新。

📊 智能空氣質量預報

提供未來數小時的空氣質量預測，幫助您提前規劃戶外活動，避開汙染高峰時段。

📈 歷史數據查詢

查看過去72小時的空氣質量變化趨勢，瞭解汙染模式和時間規律。

🗺️ 可視化熱力圖

生成空氣質量熱力圖，直觀展示區域汙染分佈，支持多種國際標準（美國AQI、中國標準等）。

🤖 自然語言查詢

使用地名直接查詢，無需記憶座標。AI助手自動解析'巴黎埃菲爾鐵塔'等位置描述。

🌐 多國標準支持

支持美國EPA、英國DEFRA、德國UBA、加拿大AQHI、法國ATMO等多種空氣質量標準。

優勢

數據權威準確：基於Google空氣質量API，數據來源可靠

全球覆蓋：支持全球幾乎所有城市和地區的查詢

使用簡便：通過自然語言即可查詢，無需技術背景

即時性強：數據更新頻率高，反映最新空氣質量狀況

多標準支持：滿足不同國家和地區的使用習慣

無縫集成：與主流AI助手完美兼容

侷限性

需要API密鑰：必須申請Google Cloud API密鑰

可能有費用：Google API超出免費額度後會產生費用

網絡依賴：需要穩定的網絡連接

部分地區數據有限：偏遠地區數據可能不夠詳細

需要基礎配置：初次使用需要簡單設置

如何使用

獲取API密鑰

訪問Google Cloud Console，創建項目並啟用Air Quality API，獲取API密鑰。

配置環境

創建.env文件並填入您的API密鑰，也可以設置服務器名稱和端口。

啟動服務器

運行Go程序啟動MCP服務器，默認在本地8080端口提供服務。

連接AI助手

在AI助手設置中添加MCP服務器地址：http://localhost:8080/mcp

開始查詢

直接在AI助手中使用自然語言查詢空氣質量，如'查詢北京現在的空氣質量'。

使用案例

旅行規劃

計劃前往新城市旅行前，查詢目的地的空氣質量狀況，選擇空氣質量較好的時間段出行。

健康監測

哮喘患者或呼吸道敏感人群監測居住區域空氣質量，合理安排戶外活動時間。

環境研究

研究人員分析城市汙染變化規律，比較不同區域的空氣質量差異。

戶外活動安排

學校或活動組織者根據空氣質量安排體育課、運動會等戶外活動。

常見問題

這個服務是免費的嗎？

需要編程知識才能使用嗎？

數據更新頻率是多少？

支持哪些國家和地區？

如何獲取API密鑰？

可以同時查詢多個地點嗎？

遇到'API key not valid'錯誤怎麼辦？

🚀 Google空氣質量MCP服務器

Google空氣質量MCP服務器是一個模型上下文協議（MCP）服務器，它提供對Google空氣質量API的訪問，使AI助手能夠檢索即時空氣質量數據、預報、歷史信息和熱圖可視化。

🚀 快速開始

前提條件

Go 1.21或更高版本
Google空氣質量API密鑰（請參閱API密鑰設置）

安裝步驟

克隆倉庫

git clone git@github.com:ContexaAI/google-air-quality-mcp.git
cd google-air-quality-mcp

安裝依賴項

go mod download

配置環境變量

在項目根目錄下創建一個.env文件：

GOOGLE_AIR_QUALITY_API_KEY=your_api_key_here
MCP_SERVER_NAME=Google Air Quality MCP Server
PORT=8080

運行服務器

go run cmd/server/main.go

服務器將在http://localhost:8080啟動，MCP端點位於/mcp。

使用MCP檢查器連接

打開MCP檢查器
連接到http://localhost:8080/mcp
探索可用的工具、提示和資源

✨ 主要特性

🌍 即時空氣質量數據 - 全球任何地點的當前空氣質量狀況
📊 預報 - 每小時的空氣質量預測
📈 歷史數據 - 訪問過去的空氣質量測量值
🗺️ 熱圖可視化 - 生成空氣質量熱圖切片
🤖 對大語言模型友好的提示 - 支持自然語言位置查詢
📦 MCP資源 - 通過URI模板訪問結構化數據

📦 安裝指南

克隆倉庫

git clone git@github.com:ContexaAI/google-air-quality-mcp.git
cd google-air-quality-mcp

安裝依賴項

go mod download

配置環境變量

在項目根目錄下創建.env文件，並按如下示例配置：

GOOGLE_AIR_QUALITY_API_KEY=your_api_key_here
MCP_SERVER_NAME=Google Air Quality MCP Server
PORT=8080

💻 使用示例

使用工具

獲取舊金山的當前空氣質量：

{
  "name": "get_current_air_quality",
  "arguments": {
    "latitude": 37.7749,
    "longitude": -122.4194,
    "universalAqi": true
  }
}

獲取紐約的24小時空氣質量預報：

{
  "name": "get_air_quality_forecast",
  "arguments": {
    "latitude": 40.7128,
    "longitude": -74.0060,
    "pageSize": 24
  }
}

獲取倫敦的歷史空氣質量數據：

{
  "name": "get_air_quality_history",
  "arguments": {
    "latitude": 51.5074,
    "longitude": -0.1278,
    "hours": 72
  }
}

使用提示

提示允許你使用自然語言位置名稱，大語言模型將自動將其解析為座標。

提示使用示例：

Use the current_air_quality_by_location_prompt with location "Tokyo, Japan"

大語言模型將執行以下操作：

將“東京，日本”解析為座標 (35.6762, 139.6503)
使用這些座標調用get_current_air_quality工具
返回空氣質量數據

使用資源

讀取服務器信息：

URI: example://server-info

這將返回有關服務器和可用資源的基本信息。

📚 詳細文檔

API密鑰設置

步驟1：啟用API

訪問Google Cloud控制檯
創建一個新項目或選擇一個現有項目
導航到API和服務 > 庫
搜索“空氣質量API”
點擊啟用

步驟2：創建API憑證

轉到API和服務 > 憑證
點擊創建憑證 > API密鑰
複製生成的API密鑰
（建議）點擊限制密鑰並進行以下設置：
- 在API限制下，選擇“限制密鑰”
- 從下拉菜單中選擇“空氣質量API”
- 在應用程序限制下，你可以按IP、HTTP引用等進行限制

步驟3：配置服務器

將你的API密鑰添加到.env文件中：

GOOGLE_AIR_QUALITY_API_KEY=AIzaSyD...your-key-here

⚠️ 重要提示

空氣質量API可能要求在你的Google Cloud項目上啟用計費。請查看定價頁面瞭解詳細信息。

API參考

工具

工具名稱	描述	必需參數	可選參數
`get_current_air_quality`	獲取特定位置的當前空氣質量狀況	`latitude` (float) `longitude` (float)	`universalAqi` (bool) `languageCode` (string) `extraComputations` (array) `uaqiColorPalette` (string)
`get_air_quality_forecast`	獲取每小時的空氣質量預報	`latitude` (float) `longitude` (float)	`pageSize` (int) `pageToken` (string) `universalAqi` (bool) `languageCode` (string) `extraComputations` (array)
`get_air_quality_history`	獲取歷史空氣質量數據	`latitude` (float) `longitude` (float)	`hours` (int) `pageSize` (int) `pageToken` (string) `universalAqi` (bool) `languageCode` (string)
`get_air_quality_heatmap_tile`	獲取用於可視化的熱圖切片圖像	`mapType` (string) `zoom` (int) `x` (int) `y` (int)	-

熱圖的有效地圖類型

UAQI_RED_GREEN - 具有紅綠調色板的通用空氣質量指數
UAQI_INDIGO_PERSIAN - 具有靛藍 - 波斯調色板的通用空氣質量指數
PM25_INDIGO_PERSIAN - PM2.5濃度熱圖
GBR_DEFRA - 英國DEFRA指數
DEU_UBA - 德國UBA指數
CAN_EC - 加拿大AQHI
FRA_ATMO - 法國ATMO指數
US_AQI - 美國EPA AQI

提示

提示名稱	描述	參數
`current_air_quality_by_location_prompt`	使用人類可讀的位置名稱獲取當前空氣質量（大語言模型將解析為座標）	`location` (string) - 例如，"巴黎，法國"
`air_quality_forecast_by_location_prompt`	獲取某個位置的空氣質量預報	`location` (string) `pageSize` (int, 可選)
`air_quality_history_by_location_prompt`	獲取某個位置的歷史空氣質量數據	`location` (string) `hours` (int, 可選)
`air_quality_heatmap_by_location_prompt`	獲取某個位置的熱圖切片	`location` (string) `mapType` (string) `zoom` (int)
`air_quality_heatmap_prompt`	使用直接座標獲取熱圖切片	`mapType` (string) `x` (int) `y` (int) `zoom` (int)

資源

資源URI	類型	描述	內容類型
`example://server-info`	靜態	基本服務器信息和可用資源	`text/plain`

項目結構

.
├── cmd/
│   └── server/              # 服務器入口點
├── internal/
│   ├── capabilities/        # MCP功能
│   │   ├── prompts/        # 提示定義和處理程序
│   │   ├── resources/      # 資源定義和處理程序
│   │   └── tools/          # 工具實現
│   │       ├── client.go   # Google空氣質量API客戶端
│   │       ├── types.go    # 共享類型和結構
│   │       ├── current_conditions.go
│   │       ├── forecast.go
│   │       ├── history.go
│   │       └── heatmap.go
│   ├── config/             # 配置管理
│   └── mcp/                # MCP服務器設置
├── .env                    # 環境變量（不在git中）
├── .gitignore
├── go.mod
├── go.sum
└── README.md

開發

構建

go build -o bin/server cmd/server/main.go

運行

./bin/server

測試

go test ./...

配置

環境變量（在.env中設置）：

變量	描述	默認值	是否必需
`GOOGLE_AIR_QUALITY_API_KEY`	你的Google空氣質量API密鑰	-	✅ 是
`MCP_SERVER_NAME`	MCP服務器的顯示名稱	`Google Air Quality MCP Server`	否
`PORT`	HTTP服務器端口	`8080`	否