Skip to main content
Glama
deenesjakoruzh
pipeworx-io

mcp-openaq

by pipeworx-io
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

mcp-openaq

OpenAQ MCP — глобальные измерения качества воздуха через API OpenAQ v3.

Часть Pipeworx — MCP-шлюза, соединяющего ИИ-агентов с 1476+ источниками данных в реальном времени.

Инструменты

Инструмент

Описание

air_quality_near

Получите последние показания качества воздуха (PM2.5, PM10, O3, NO2, SO2, CO и т.д.) на станции мониторинга, БЛИЖАЙШЕЙ к широте/долготе. ПРЕДПОЧТИТЕЛЬНО для запросов «качество воздуха рядом со мной», «какое качество воздуха по координатам », «плохой ли сейчас воздух в ». Возвращает ближайшую станцию с её самыми свежими значениями загрязняющих веществ, а также другие ближайшие станции.

find_stations

Находит станции мониторинга качества воздуха OpenAQ по местоположению: город или название места, координаты + радиус (сначала ближайшие), страна (код ISO 3166-1 alpha-2) или ограничивающий прямоугольник. Возвращает идентификатор станции, название, страну, координаты и загрязняющие вещества, которые измеряет каждая станция (с идентификаторами датчиков), а также resolved_place, отражающий координаты, в которые разрешилось название города. Это первый шаг для получения исторического ряда: найдите станцию здесь, затем передайте её sensor_id в get_measurements. Требуется хотя бы один аргумент местоположения — инструмент не вернёт нефильтрованный глобальный список.

get_latest

Получает последнее показание по каждому загрязняющему веществу на конкретной станции OpenAQ (по идентификатору местоположения из find_stations). Возвращает каждый параметр (PM2.5, O3, NO2 и т.д.) с его значением, единицами измерения и временем измерения.

get_measurements

Получает самый свежий временной ряд (почасовые или суточные агрегаты) для одного датчика OpenAQ (идентификатор датчика из find_stations), сначала новые. Используйте для отслеживания трендов загрязняющих веществ с течением времени на одной станции/по одному параметру. Возвращает ПОСЛЕДНИЕ limit показаний датчика — учтите, что многие датчики OpenAQ архивированы и перестали передавать данные много лет назад, поэтому «самые свежие» могут по праву быть многолетней давности: всегда читайте возвращаемые временные метки, а не предполагайте, что данные актуальны. Используйте find_stations или get_latest, чтобы выбрать датчик, который всё ещё передаёт данные.

Related MCP server: gios-air-mcp

Быстрый старт

Добавьте в ваш MCP-клиент (Claude Desktop, Cursor, Windsurf и т.д.):

{
  "mcpServers": {
    "openaq": {
      "url": "https://gateway.pipeworx.io/openaq/mcp"
    }
  }
}

Что на самом деле отдаёт эта конечная точка

tools/list по адресу https://gateway.pipeworx.io/openaq/mcp возвращает инструменты из таблицы выше плюс общие мета-инструменты Pipeworx — ask_pipeworx, discover_tools, search_within, remember/recall и остальной набор, общий для всего шлюза. Поэтому количество инструментов, которое вы видите, больше, чем в этой таблице: конечная точка одного пакета в настоящее время перечисляет примерно 30 общих инструментов рядом с собственными инструментами пакета. Ответ initialize соединения указывает его точную область действия и является авторитетным ответом для конкретного дня.

Это сделано намеренно, а не случайное мультиплексирование. Мета-инструменты позволяют ограниченному соединению ответить на вопрос, который этот пакет не покрывает, — через ask_pipeworx, который маршрутизирует запрос по всему каталогу, — без необходимости добавлять второй MCP-сервер. Сейчас невозможно подключить конечную точку пакета без них; если дополнительные схемы стоят вам больше контекста, чем стоит маршрутизация, подключитесь один раз к полному шлюзу, а не к нескольким конечным точкам пакетов.

Или подключитесь к полному шлюзу Pipeworx, чтобы получить список инструментов всех пакетов напрямую, а не только этого:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

Оба URL-адреса ведут к одному и тому же шлюзу и к одним и тем же 1476+ источникам данных. Единственное отличие — инструменты какого пакета перечислены напрямую; ask_pipeworx добирается до всех них из любого из этих вариантов.

Использование с ask_pipeworx

Вместо прямого вызова инструментов вы можете задавать вопросы на простом английском — это работает как на конечной точке пакета выше, так и на полном шлюзе:

ask_pipeworx({ question: "your question about Openaq data" })

Шлюз сам выбирает подходящий инструмент и автоматически заполняет аргументы.

Дополнительно

Лицензия

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers