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`	否