AQICN MCP Server

Name: AQICN MCP Server
Author: mattmarcin

@mattmarcin

リポジトリ

AQICN MCP Server について

An MCP server to get Air Quality Data using AQICN.org

#aqicn #air-quality #data-tools

基本情報

カテゴリ

その他

トランスポート

stdio

公開者

mattmarcin

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "aqicn-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@mattmarcin/aqicn-mcp",
        "--client",
        "claude"
      ]
    }
  }
}

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

What is 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.

How to use AQICN MCP Server?

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.

Key features of AQICN MCP Server

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

Use cases of AQICN MCP Server

Retrieve the current AQI for a specific city (e.g., Beijing)
Get air quality data for a location using latitude/longitude (e.g., Tokyo)
Search for monitoring stations matching a keyword (e.g., "london")

FAQ from AQICN MCP Server

What tools are available?

Three tools: city_aqi (by city name), geo_aqi (by coordinates), and search_station (by keyword).

How do I install the server?

Install automatically via Smithery or manually using uv and pip install -e ..

How do I set up the API key?

Create a .env file with AQICN_API_KEY=your_key or set it as an environment variable in your shell.

What data does `city_aqi` return?

Returns AQI value, station name, dominant pollutant (if available), measurement timestamp, and station coordinates.

How do I search for stations?

Use the search_station tool with a keyword (city name, station name, etc.) to get a list of matching stations with their IDs and coordinates.

「その他」の他のコンテンツ

FastMCP v2 🚀

jlowin

🚀 The fast, Pythonic way to build MCP servers and clients.

26.0K

Inbox Zero AI

elie222

The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.

11.6K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K