AQICN MCP Server
About
An MCP server to get Air Quality Data using AQICN.org
Details
- Author
- mattmarcin
- Downloads
- 326
- Categories
- Other
Jump to
- city_aqi: get air quality data by city name
- geo_aqi: get air quality data by coordinates
- search_station: search monitoring stations by keyword
- Real‑time AQI, station, pollutant, time, coordinates
- Worldwide coverage through the AQICN project
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
AQICN MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install via Smithery (npx -y @smithery/cli install @mattmarcin/aqicn-mcp --client claude) or manually with uv pip install -e .. Set the AQICN_API_KEY environment variable in a .env file or export it. Run in development mode with mcp dev aqicn_server.py, install in Claude Desktop with mcp install aqicn_server.py, or execute directly with python aqicn_server.py. Use the provided tools (city_aqi, geo_aqi, search_station) via the MCP client.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"aqicn mcp server": {
"aqicn-mcp": {
"command": "npx",
"args": [
"-y",
"@smithery/cli",
"install",
"@mattmarcin/aqicn-mcp",
"--client",
"claude"
]
}
}
}
}McpServers
{
"aqicn-mcp": {
"command": "npx",
"args": [
"-y",
"@smithery/cli",
"install",
"@mattmarcin/aqicn-mcp",
"--client",
"claude"
]
}
}AQICN MCP Server
This is a Model Context Protocol (MCP) server that provides air quality data tools from the World Air Quality Index (AQICN) project. It allows LLMs to fetch real-time air quality data for cities and coordinates worldwide.
Installation
Installing via Smithery
To install AQICN MCP Server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @mattmarcin/aqicn-mcp --client claude
Installing via recommended uv (manual)
We recommend using uv to manage your Python environment:
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
