UBOS Asset Marketplace: AQICN MCP Server - Empowering AI Agents with Real-Time Air Quality Data

In the rapidly evolving landscape of AI, the ability to access and interpret real-world data is paramount. UBOS understands this need and provides a robust platform for AI Agent development, enabling businesses to create intelligent applications that are both powerful and practical. A crucial component of this platform is the UBOS Asset Marketplace, a curated collection of tools and integrations that extend the capabilities of AI Agents. Among these valuable assets is the AQICN MCP Server, a game-changing solution for integrating real-time air quality data into AI-driven applications.

What is an MCP Server, and Why Does It Matter?

Before delving into the specifics of the AQICN MCP Server, it’s essential to understand the underlying technology: Model Context Protocol (MCP). MCP is an open protocol that standardizes how applications provide context to Large Language Models (LLMs). Think of it as a universal translator, allowing AI models to seamlessly access and utilize external data sources and tools. An MCP server acts as a bridge, enabling AI models to interact with the real world through APIs and other interfaces.

UBOS, as a full-stack AI Agent Development Platform, deeply emphasizes the importance of MCP servers. Our platform helps you orchestrate AI Agents, connect them with your enterprise data, build custom AI Agents with your LLM model and Multi-Agent Systems, all while leveraging the power of MCP servers.

The AQICN MCP Server: Breathing Life into Location-Aware AI

The AQICN MCP Server is a specific implementation of the MCP protocol designed to provide access to air quality data from the World Air Quality Index (AQICN) project. This server empowers AI Agents with the ability to:

• Fetch Real-Time Air Quality Data: Access up-to-the-minute air quality information for cities and geographic coordinates worldwide.
• Understand Environmental Context: Integrate air quality data into decision-making processes, enabling AI Agents to make informed choices based on environmental conditions.
• Develop Location-Aware Applications: Create AI-powered solutions that are sensitive to their surroundings and can adapt to changing air quality levels.

Key Features and Functionality

The AQICN MCP Server offers a suite of powerful tools, each designed to provide specific air quality information:

1. city_aqi: This tool allows AI Agents to retrieve air quality data for a specified city. By providing the city name, the agent receives a comprehensive report including:

   • AQI (Air Quality Index): A numerical representation of the air quality level.
   • Station: The name of the monitoring station providing the data.
   • Dominant Pollutant: The primary pollutant affecting air quality (if available).
   • Time: The timestamp of the measurement.
   • Coordinates: The latitude and longitude of the monitoring station.

   Use Case: An AI-powered travel assistant could use this tool to advise users on the best times to visit a particular city, taking into account air quality conditions.

2. geo_aqi: This tool enables AI Agents to obtain air quality data for a specific location using geographic coordinates (latitude and longitude). The output is identical to the city_aqi tool.

   Use Case: An AI-driven drone delivery service could use this tool to dynamically adjust flight paths to avoid areas with poor air quality, minimizing the risk of damage to sensitive equipment.

3. search_station: This tool allows AI Agents to search for air quality monitoring stations based on keywords (city name, station name, etc.). The output is a list of StationInfo objects, each containing:

   • Name: The name of the station.
   • Station ID: A unique identifier for the station.
   • Coordinates: The latitude and longitude of the station.

   Use Case: An AI-powered research assistant could use this tool to identify all air quality monitoring stations in a specific region, enabling researchers to access historical data for analysis.

Installation and Setup

The AQICN MCP Server is designed for easy installation and integration into the UBOS platform. You can install it using either Smithery or manual methods with uv, ensuring compatibility with various development environments.

• Installation via Smithery: Use the Smithery CLI for automated installation within Claude Desktop. This provides a streamlined experience, especially for users already familiar with the Smithery ecosystem.

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

• Manual Installation with uv: For more control over the installation process, use the recommended uv package manager to create a Python environment and install the necessary dependencies.

  bash uv pip install -e .

Regardless of the installation method, you’ll need an API key from AQICN.org. This key allows the server to access the air quality data. You can store the API key in a .env file or set it as an environment variable.

Example Usage: Bringing Air Quality Data to Life

The following Python code snippet demonstrates how to use the AQICN MCP Server with the MCP Python client:

python 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})")

This example showcases the simplicity and power of the AQICN MCP Server. With just a few lines of code, you can integrate real-time air quality data into your AI Agents.

Use Cases: Transforming Industries with Air Quality Awareness

The AQICN MCP Server unlocks a wide range of potential applications across various industries:

• Healthcare: AI-powered health monitoring systems can use air quality data to provide personalized recommendations to individuals with respiratory conditions, such as asthma or COPD. The system could advise users to stay indoors during periods of high pollution or suggest optimal times for outdoor exercise.

• Urban Planning: City planners can use air quality data to optimize traffic flow, identify pollution hotspots, and evaluate the effectiveness of environmental policies. AI Agents can analyze data from multiple sources to create simulations and models that predict the impact of different urban development strategies on air quality.

• Logistics and Transportation: Shipping companies and logistics providers can leverage air quality data to optimize delivery routes, minimizing exposure to pollutants for drivers and reducing the environmental impact of their operations. AI Agents can dynamically adjust routes based on real-time air quality conditions, taking into account factors such as wind direction and traffic patterns.

• Insurance: Insurance companies can use air quality data to assess the risk of property damage caused by pollution and offer customized insurance policies to homeowners and businesses. AI Agents can analyze historical air quality data to identify areas that are prone to high levels of pollution and adjust premiums accordingly.

• Smart Agriculture: Farmers can use air quality data to optimize irrigation and fertilization strategies, minimizing the impact of pollution on crop yields. AI Agents can analyze air quality data in conjunction with weather forecasts and soil conditions to provide farmers with real-time recommendations on how to protect their crops from pollution damage.

Why Choose UBOS and the AQICN MCP Server?

UBOS provides a comprehensive ecosystem for AI Agent development, offering a range of tools and resources to help you build and deploy intelligent applications quickly and efficiently. The AQICN MCP Server is just one example of the many valuable assets available in the UBOS Asset Marketplace.

Here are some key reasons to choose UBOS:

• Full-Stack Platform: UBOS provides all the necessary components for AI Agent development, from data integration to model deployment.
• Open and Extensible: The UBOS platform is built on open standards and is designed to be easily extended with custom tools and integrations.
• Community-Driven: UBOS has a vibrant community of developers and users who are constantly contributing to the platform.
• Enterprise-Grade Security: UBOS provides robust security features to protect your data and applications.
• Scalable and Reliable: The UBOS platform is designed to scale to meet the needs of even the most demanding applications.

By leveraging the power of UBOS and the AQICN MCP Server, you can create AI Agents that are not only intelligent but also environmentally aware, contributing to a more sustainable and healthy future.

In conclusion, the AQICN MCP Server on the UBOS Asset Marketplace is a powerful tool for integrating real-time air quality data into AI-driven applications. Its ease of use, comprehensive feature set, and wide range of potential use cases make it an invaluable asset for businesses and organizations looking to leverage the power of AI to address environmental challenges and create a better world.