AQICN MCP Server

一个用于查询中国城市空气质量信息的 MCP 服务器，直接查询实时空气质量数据。

功能特性

• 根据城市拼音查询实时空气质量指数 (AQI)
• 返回完整的空气质量数据，包括 PM2.5、PM10、二氧化硫、二氧化氮等污染物信息
• 支持中国所有主要城市查询
• 提供空气质量等级描述和健康建议

安装步骤

1. 安装依赖

cd /path/to/aqicn_mcp
pip install -e .

2. 获取 API Token

访问 AQICN API 注册并获取免费的 API token。

3. 测试 API 连接

python test_aqicn.py

配置 MCP

配置内容

在配置文件的 mcpServers 部分添加以下内容：

{
  "mcpServers": {
    "aqicn": {
      "command": "python",
      "args": [
        "/path/to/aqicn_mcp/src/aqicn_mcp/server.py"
      ],
      "env": {
        "AQICN_TOKEN": "your_token_here"
      }
    }
  }
}

重要提示：

• 将 /path/to/aqicn_mcp 替换为实际的项目绝对路径
• 将 your_token_here 替换为你在 AQICN 获取的实际 API token

使用方法示例

查询北京的空气质量

上海今天的 AQI 是多少

深圳的空气污染情况怎么样

帮我看一下杭州的空气质量

返回数据说明

查询结果包含以下信息：

• AQI 指数: 空气质量指数（0-500+）
• 空气质量等级: 优、良、轻度污染、中度污染、重度污染、严重污染
• 健康建议: 针对当前空气质量等级的健康建议
• 污染物详情:
  • PM2.5: 细颗粒物
  • PM10: 可吸入颗粒物
  • 二氧化硫 (SO2)
  • 二氧化氮 (NO2)
  • 臭氧 (O3)
  • 一氧化碳 (CO)
  • 颗粒物 (P)
• 更新时间: 数据的更新时间戳

API 信息

• API 提供商: World Air Quality Index Project
• 官方网站: https://aqicn.org/api/
• 免费额度: 1000次请求/秒
• 数据更新频率: 每小时更新一次
• 数据来源: 全球各地环保部门监测站

许可和使用条款

使用本 MCP 服务器需要遵守 AQICN API 的使用条款：

• 数据不可用于商业付费应用
• 免费使用，但需遵守 API 调用限制
• 详见: https://aqicn.org/api/

故障排除

MCP 服务器无法启动

• 检查 Python 路径是否正确
• 确认已安装所有依赖: pip install -e .
• 检查 AQICN_TOKEN 是否正确设置

查询失败

• 验证 API token 是否有效
• 检查网络连接
• 确认城市拼音拼写正确
• 查看 API 是否在正常服务

项目结构

aqicn_mcp/
├── src/aqicn_mcp/
│   ├── __init__.py
│   └── server.py          # MCP 服务器主程序
├── test_aqicn.py           # API 测试脚本
├── README.md               # 项目文档
└── pyproject.toml          # 项目配置

技术栈

• Python 3.8+
• MCP SDK (Model Context Protocol)
• httpx (异步 HTTP 客户端)
• AQICN API

贡献

欢迎提交 Issue 和 Pull Request！

许可证

MIT License