AQICN MCP Server

基本能力

产品定位

AQICN MCP Server 是一个提供全球空气质量数据的服务，主要用于获取和查询实时空气质量信息。

核心功能

1. city_aqi: 获取特定城市的空气质量数据。
2. geo_aqi: 使用坐标获取特定位置的空气质量数据。
3. search_station: 通过关键词搜索空气质量监测站。

适用场景

1. 实时空气质量监测。
2. 环境健康研究。
3. 地理位置服务集成。

工具列表

1. city_aqi: 获取特定城市的空气质量数据，包括 AQI 值、监测站名称、主要污染物、测量时间和坐标。
2. geo_aqi: 使用经纬度坐标获取特定位置的空气质量数据，输出与 city_aqi 相同。
3. search_station: 通过关键词搜索空气质量监测站，返回站名、站 ID 和坐标。

常见问题解答

1. 如何获取 API 密钥？ 需要在 .env 文件中设置 AQICN_API_KEY 环境变量。
2. 如何调试？ 使用 mcp dev aqicn_server.py 命令进行开发和调试。

使用教程

使用依赖

1. 安装 Python 环境。
2. 推荐使用 uv 管理 Python 环境。

安装教程

1. 通过 Smithery 安装:

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

1. 手动安装:

uv pip install -e .

环境设置

1. 创建 .env 文件并设置 AQICN_API_KEY:

# .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

运行服务器

1. 开发模式:

mcp dev aqicn_server.py

1. Claude Desktop 集成:

mcp install aqicn_server.py

1. 直接执行:

python aqicn_server.py

调试方式

1. 使用 mcp dev aqicn_server.py 进行开发和调试。
2. 检查 .env 文件中的 AQICN_API_KEY 是否正确设置。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。