Servidor MCP de AQICN

Este es un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona herramientas de datos de calidad del aire del proyecto Índice Mundial de Calidad del Aire (AQICN). Permite a los LLM obtener datos de calidad del aire en tiempo real de ciudades y coordenadas de todo el mundo.

Instalación

Instalación mediante herrería

Para instalar AQICN MCP Server para Claude Desktop automáticamente a través de Smithery :

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

Instalación mediante UV recomendada (manual)

Recomendamos utilizar uv para administrar su entorno Python:

# Install the package and dependencies
uv pip install -e .

Configuración del entorno

Cree un archivo .env en la raíz del proyecto (puede copiarlo desde .env.example ):

# .env
AQICN_API_KEY=your_api_key_here

Alternativamente, puede configurar la variable de entorno directamente:

# Linux/macOS
export AQICN_API_KEY=your_api_key_here

# Windows
set AQICN_API_KEY=your_api_key_here

Ejecución del servidor

Modo de desarrollo

La forma más rápida de probar y depurar su servidor es con el Inspector MCP:

mcp dev aqicn_server.py

Integración de escritorio de Claude

Una vez que su servidor esté listo, instálelo en Claude Desktop:

mcp install aqicn_server.py

Ejecución directa

Para pruebas o implementaciones personalizadas:

python aqicn_server.py

Herramientas disponibles

1. ciudad_aqi

Obtenga datos de calidad del aire para una ciudad específica.

@mcp.tool()
def city_aqi(city: str) -> AQIData:
    """Get air quality data for a specific city."""

Aporte:

city : Nombre de la ciudad de la que se obtendrán datos de calidad del aire

Salida: AQIData con:

aqi : valor del índice de calidad del aire
station : Nombre de la estación
dominant_pollutant : Contaminante principal (si está disponible)
time : Marca de tiempo de la medición
coordinates : Latitud y longitud de la estación

2. geo_aqi

Obtenga datos de calidad del aire para una ubicación específica utilizando coordenadas.

@mcp.tool()
def geo_aqi(latitude: float, longitude: float) -> AQIData:
    """Get air quality data for a specific location using coordinates."""

Aporte:

latitude : Latitud de la ubicación
longitude : Longitud de la ubicación

Salida: Igual que city_aqi

3. estación de búsqueda

Busque estaciones de monitoreo de calidad del aire por palabra clave.

@mcp.tool()
def search_station(keyword: str) -> list[StationInfo]:
    """Search for air quality monitoring stations by keyword."""

Aporte:

keyword : Palabra clave para buscar estaciones (nombre de la ciudad, nombre de la estación, etc.)

Salida: Lista de StationInfo con:

name : Nombre de la estación
station_id : Identificador único de la estación
coordinates : Latitud y longitud de la estación

Ejemplo de uso

Usando el cliente Python de MCP:

from mcp import Client

async with Client() as client:
    # Get air quality data for Beijing
    beijing_data = await client.city_aqi(city="beijing")
    print(f"Beijing AQI: {beijing_data.aqi}")

    # Get air quality data by coordinates (Tokyo)
    geo_data = await client.geo_aqi(latitude=35.6762, longitude=139.6503)
    print(f"Tokyo AQI: {geo_data.aqi}")

    # Search for stations
    stations = await client.search_station(keyword="london")
    for station in stations:
        print(f"Station: {station.name} ({station.coordinates})")

Contribuyendo

No dude en abrir problemas y solicitudes de incorporación de cambios. Asegúrese de que sus cambios incluyan pruebas y documentación adecuadas.

Licencia

Este proyecto está licenciado bajo la licencia MIT.

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Permite la interacción con el Índice Mundial de Calidad del Aire para obtener datos de calidad del aire en tiempo real para ciudades y coordenadas de todo el mundo a través del Protocolo de Contexto de Modelo (MCP).

Related Resources

Reddit Discussion about this server

Related MCP Servers

WeatherAPI MCP Server
swonixs
-
security
F
license
-
quality
Provides current weather and air quality data for any city using WeatherAPI, easily integrating with MCP clients like n8n and Claude Desktop App.
Last updated -
681
JavaScript
Weather MCP Tool
jalaj-pandey
-
security
F
license
-
quality
An India-focused MCP server that provides real-time weather conditions, forecasts, air quality data, and location search capabilities using the OpenWeatherMap API.
Last updated -
Python
AirNow MCP Server
prsantos-com
A
security
A
license
A
quality
A Model Context Protocol implementation that enables LLMs to access real-time, forecasted, and historical U.S. air quality data through the AirNow API.
Last updated -
10
3
TypeScript
MIT License
Said MCP
JunLovin
-
security
F
license
-
quality
A MCP server that provides real-time weather information for any city through a simple tool that resolves geographic coordinates and fetches current weather data.
Last updated -
8
TypeScript

View all related MCP servers

AQICN MCP Server