Skip to main content
Glama

mcp-openaq

OpenAQ MCP — OpenAQ v3 API를 통한 전 세계 대기질 측정.

Pipeworx의 일부 — AI 에이전트를 1476개 이상의 실시간 데이터 소스에 연결하는 MCP 게이트웨이.

도구

도구

설명

air_quality_near

위도/경도에서 가장 가까운 모니터링 스테이션의 최신 대기질 측정값(PM2.5, PM10, O3, NO2, SO2, CO 등)을 가져옵니다. "내 주변 대기질", "<좌표>의 대기질은 어떤가요", "<장소>의 공기가 지금 나쁜가요" 같은 질문에 적합합니다. 가장 가까운 스테이션의 최신 오염물질 값과 함께 주변의 다른 스테이션도 반환합니다.

find_stations

위치로 OpenAQ 대기질 모니터링 스테이션을 찾습니다: 도시 또는 장소 이름, 좌표+반경(가까운 순), 국가(ISO 3166-1 alpha-2 코드), 또는 경계 상자. 스테이션 ID, 이름, 국가, 좌표, 각 스테이션이 측정하는 오염물질(센서 ID 포함)을 반환하며, 도시 이름이 해석된 좌표를 반영하는 resolved_place도 반환합니다. 이는 과거 시계열 데이터의 첫 단계입니다: 여기서 스테이션을 찾은 다음 해당 sensor_id를 get_measurements에 전달하세요. 최소 하나의 위치 인수가 필요합니다 — 이 도구는 필터링되지 않은 전체 목록을 반환하지 않습니다.

get_latest

특정 OpenAQ 스테이션(find_stations의 location id 사용)에서 모든 오염물질의 최신 측정값을 가져옵니다. 각 파라미터(PM2.5, O3, NO2 등)를 값, 단위, 측정 시간과 함께 반환합니다.

get_measurements

단일 OpenAQ 센서(find_stations의 sensor id)의 가장 최근 시계열(시간별 또는 일별 집계)을 최신순으로 가져옵니다. 한 스테이션/파라미터의 시간에 따른 오염물질 추세에 사용합니다. 센서의 마지막 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"
    }
  }
}

이 엔드포인트가 실제로 제공하는 것

https://gateway.pipeworx.io/openaq/mcp의 tools/list는 위 표의 도구들 에 더해 공유 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

Related MCP Connectors

Related MCP Servers