Skip to main content
Glama

ARIMAIR MCP 서버

아림에어 모니터링 시스템의 측정 데이터·통계·보정·리포트를 Claude에서 직접 조회하는 MCP(stdio) 서버.

조회 전용입니다. 서버 상태를 바꾸는 기능(리포트 발행, 보정 적용, 디바이스 명령, 백필, 알람 등록/삭제)은 포함하지 않습니다.

설치

Node.js 18 이상이 필요합니다.

macOS / Linux

cd /Users/<사용자>/Project/arimair-mcp
npm install
npm run build
./setup-arim-mcp.sh     # Claude Code + Claude Desktop 자동 등록

Windows

저장소를 원하는 위치(예: C:\Users\<사용자>\arimair-mcp)에 두고, 그 폴더에서 실행합니다. 설치 스크립트는 자기 위치를 기준으로 경로를 잡으므로 어디에 두든 그대로 동작합니다.

PowerShell에서:

cd C:\Users\<사용자>\arimair-mcp
npm install
npm run build
powershell -ExecutionPolicy Bypass -File .\setup-arim-mcp.ps1

-ExecutionPolicy Bypass는 서명되지 않은 스크립트 실행을 이번 한 번만 허용하는 옵션입니다. 시스템 정책을 바꾸지 않습니다.

설치 스크립트가 하는 일 (공통)

서버 주소는 운영 서버(https://monitor.arimair.com)로 고정되어 있어 묻지 않습니다. 두 스크립트 모두 아이디·비밀번호·계정 유형만 물어본 뒤 아래 두 곳에 등록합니다.

  • Claude Code CLI (claude mcp add arim -s user) — claude 명령이 없으면 건너뜁니다

  • Claude Desktop 설정 파일 — 기존 파일은 .bak.<타임스탬프>로 백업하고, 이미 등록된 다른 MCP 서버는 보존합니다

OS

Claude Desktop 설정 경로

macOS

~/Library/Application Support/Claude/claude_desktop_config.json

Windows

%APPDATA%\Claude\claude_desktop_config.json

등록 후 Claude Desktop을 완전히 종료했다가 다시 열어야 도구가 나타납니다.

수동 등록

# macOS / Linux
claude mcp add arim -s user -t stdio \
  -e ARIM_API_BASE_URL=https://monitor.arimair.com \
  -e ARIM_MCP_USER=<아이디> \
  -e ARIM_MCP_PASS=<비밀번호> \
  -- node /Users/<사용자>/Project/arimair-mcp/build/index.js
# Windows (PowerShell) — 경로는 실제 설치 위치로
claude mcp add arim -s user -t stdio `
  -e "ARIM_API_BASE_URL=https://monitor.arimair.com" `
  -e "ARIM_MCP_USER=<아이디>" `
  -e "ARIM_MCP_PASS=<비밀번호>" `
  -- node C:\Users\<사용자>\arimair-mcp\build\index.js

비밀번호를 등록하지 않았다면 연결 후 arim_login 도구로 로그인하면 됩니다.

Related MCP server: GigAPI MCP Server

환경 변수

변수

기본값

설명

ARIM_API_BASE_URL

https://monitor.arimair.com

대상 서버 주소. 설치 스크립트가 이 값으로 고정 등록하므로 평소 건드릴 일이 없고, 로컬 서버로 붙여 테스트할 때만 http://localhost:9080 등으로 바꿉니다

ARIM_MCP_USER

—

자동 로그인 아이디

ARIM_MCP_PASS

—

자동 로그인 비밀번호

ARIM_MCP_USER_TYPE

admin

admin 또는 user

ARIM_API_TIMEOUT

20000

요청 타임아웃(ms)

자격증명을 환경변수로 넣어두면 첫 도구 호출 시 자동 로그인하고, 세션이 만료되면 한 번 재로그인 후 재시도합니다.

인증 방식

ARIM 서버는 JWT를 발급하지 않고 HttpSession + 세션 쿠키(Spring Session 의 SESSION)로 인증합니다. MCP는 /account/login 호출로 받은 쿠키를 보관해 이후 요청에 실어 보냅니다.

모든 요청에 X-Mcp-Client: 1 헤더를 붙입니다. 서버의 AuthorizeInterceptor는 이 헤더가 있으면 로그인 페이지로 302 리다이렉트하는 대신 401 JSON을 돌려주며, MCP는 이를 세션 만료로 판단해 재로그인합니다.

사이트

측정기·측정데이터·통계·리포트 조회는 모두 현재 선택된 사이트를 기준으로 합니다. 서버 내부적으로는 세션의 monitorId(모니터링 대상 관리자 계정)이지만, 도구에서는 "사이트"로 다룹니다. 웹 화면 상단의 사이트 선택 콤보와 같은 것입니다.

site_list                        → 선택 가능한 사이트와 현재 사이트
site_select { site: "울산 환경보건센터" }   → 사이트 변경

site_select는 사이트 이름 일부만 줘도 됩니다. 등록된 이름과 말하는 순서가 달라도(예: 등록명은 [환경보건센터] 울산 울산대) 낱말이 모두 들어 있으면 찾습니다. 표시명(company)과 담당자명(name), siteId 모두를 대상으로 검색합니다.

  • 후보가 여럿이면 임의로 고르지 않고 후보 목록을 돌려줍니다 (예: "환경보건센터" → 9곳)

  • 정확한 이름이 있으면 부분일치보다 우선합니다 (예: "도로교통연구원" → arimsc_ex)

일반사용자 계정은 승인받은 공급자만, 관리자 계정은 전체 목록을 봅니다 (웹 화면과 동일한 규칙).

도구 목록

인증

도구

설명

arim_login

로그인 (환경변수 자격증명 사용 가능)

arim_whoami

로그인 상태 / monitorId / 시스템 설정 조회

arim_logout

세션 종료

사이트

도구

설명

site_list

선택 가능한 사이트 목록과 현재 사이트

site_select

조회 대상 사이트 변경

측정기

도구

설명

device_list

측정기 목록

device_get

측정기 상세

device_realtime

전체 측정기 최신값 (원시)

device_realtime_correction

전체 측정기 최신값 (보정 적용)

device_nearby_stations

인근 에어코리아 측정소

측정 데이터

도구

설명

data_search

기간 조회 (기간별 원시/시간평균/일평균 자동 전환)

data_raw_search

항상 분단위 원시 조회

data_recent

최근 수집 데이터

통계·기상

도구

설명

stat_daily_avg

평균 데이터 조회

stat_collection_rate

측정기 × 일자별 수집률(결측률)

stat_weather_stations

KMA 관측소 목록

stat_weather

KMA 관측 이력 (시간별/일별)

sensor_list

센서 메타 (단위·소수점 자릿수)

보정

도구

설명

correction_devices

보정 대상 측정기 및 적용 현황

correction_trend

보정 인자 추이 (최근 12개월)

correction_compare

보정 전/후 시계열 비교

correction_factors

특정 적용월의 보정 인자

correction_versions

보정 모델 버전 이력

리포트

도구

설명

report_list

발행 이력

report_get

이력 상세

report_months

발행 대상 월 목록

report_v2_html

신규 리포트(V2) HTML 본문

알람

도구

설명

alarm_list

알람 발생 이력

alarm_config_list

센서 임계치 문자 알림 설정

모니터링 집계

도구

설명

monitor_device_state

가동/통신 상태 집계

monitor_working_percent

정상 가동률

monitor_data_count

수집 건수 집계

monitor_fault_devices

고장·이상 측정기

monitor_search

모니터링 기준 기간 조회

monitor_rose / monitor_rose_search

오염장미도

대량 응답 처리

시계열 조회 도구는 maxRows(기본 500)를 받습니다. 서버는 행 수 상한이 없어 1일치 분단위 조회만으로도 1,400행 이상이 나오므로, 초과 시 균등 간격 샘플링하고 응답에 totalRows / returnedRows / sampled를 함께 돌려줍니다. 마지막(최신) 행은 항상 보존합니다.

서버 측 의존 사항

이 MCP는 아래 서버 변경을 전제로 합니다.

위치

변경

route/AuthorizeInterceptor.java

X-Mcp-Client: 1 헤더일 때 401 JSON 반환

controller/AccountController.java

GET /account/me 추가

controller/SettingController.java

GET /setting/sensorlist 추가

/account/me, /setting/sensorlist가 없으면 arim_whoami, sensor_list, alarm_config_list(adminId 생략 시)만 동작하지 않고 나머지 도구는 정상 동작합니다. site_list도 동작하지만, /account/me가 없으면 현재 사이트를 서버에 물어볼 수 없어 이 세션에서 site_select로 고른 값을 현재 사이트로 표시합니다.

사이트 기능 자체는 서버 수정 없이 기존 API(/site/update/{id}, /admin/list, /datarequest/providerlist)만 씁니다.

Available Tools

36 tools
alarm_config_listA

센서 임계치 문자 알림 설정을 조회한다. adminId 를 생략하면 arim_whoami 의 monitorId 를 쓴다.

Inputs: adminId.

alarm_listB

발생한 알람 이력을 조회한다.

Inputs: maxRows.

arim_loginA

ARIM 모니터링 서버에 로그인해 세션을 만든다. 인자를 생략하면 ARIM_MCP_USER/ARIM_MCP_PASS 환경변수를 쓴다.

Inputs: userId, password, userType.

arim_logoutA

세션을 종료하고 쿠키를 폐기한다.

Inputs: no named parameters.

arim_whoamiA

현재 로그인 상태와 조회 필터의 기준이 되는 monitorId, 시스템 설정을 조회한다.

Inputs: no named parameters.

correction_compareA

보정 전/후 시간별 시계열을 나란히 조회한다. 보정 효과 검증에 쓴다.

Inputs: endDate (required), deviceId (required), startDate (required), maxRows.

correction_devicesB

보정 대상 측정기 목록과 보정 적용 현황을 조회한다.

Inputs: no named parameters.

correction_factorsB

특정 적용월에 사용된 보정 인자를 조회한다.

Inputs: deviceId (required), applyMonth (required).

correction_trendA

측정기의 보정 인자 변화 추이(최근 12개월)를 조회한다.

Inputs: deviceId (required), item.

correction_versionsA

보정 모델의 버전 이력(성능 지표 포함)을 조회한다.

Inputs: deviceId (required), item, limit, periodType.

data_recentB

측정기의 최근 수집 데이터를 조회한다.

Inputs: deviceId (required), maxRows.

device_getB

측정기 한 대의 상세 정보를 조회한다.

Inputs: deviceId (required).

device_listA

로그인 계정이 볼 수 있는 측정기 목록을 조회한다. (id, 이름, 주소, 경위도, 센서/네트워크 상태, 보정 적용 여부)

Inputs: no named parameters.

device_nearby_stationsA

측정기 인근의 에어코리아 측정소 목록을 거리순으로 조회한다. 보정 기준국 확인에 쓴다.

Inputs: deviceId (required).

device_realtimeA

전체 측정기의 최신 측정값을 조회한다. (보정 미적용 원시값 기준)

Inputs: no named parameters.

device_realtime_correctionA

전체 측정기의 최신 측정값을 보정 적용값으로 조회한다.

Inputs: no named parameters.

monitor_data_countB

데이터 수집 건수 집계를 조회한다.

Inputs: no named parameters.

monitor_device_stateB

측정기 가동/통신 상태 집계를 조회한다.

Inputs: no named parameters.

monitor_fault_devicesA

고장·이상 상태로 판정된 측정기 목록을 조회한다.

Inputs: no named parameters.

monitor_roseB

오염장미도(풍향별 농도 분포) 데이터를 조회한다.

Inputs: period (required).

monitor_working_percentB

측정기 정상 가동률을 조회한다.

Inputs: no named parameters.

report_getB

리포트 발행 이력 한 건의 상세를 조회한다.

Inputs: no (required).

report_listB

리포트 발행 이력을 조회한다. (측정기, 대상월, 생성/메일 발송 여부, 파일명)

Inputs: no named parameters.

report_monthsA

리포트를 발행할 수 있는 대상 월 목록을 조회한다.

Inputs: no named parameters.

report_v2_htmlA

신규 리포트(V2)의 HTML 본문을 조회한다. 저장본이 없으면 서버가 생성하며 LLM 소견 생성 때문에 오래 걸릴 수 있다.

Inputs: deviceId (required), yearMonth (required), maxChars.

sensor_listA

센서 메타 정보(항목 id, 이름, 단위, 소수점 자릿수)를 조회한다. 측정값 해석·표기에 쓴다. digit 은 'F1','F2' 형식이라 숫자만 뽑아 쓴다.

Inputs: no named parameters.

site_listA

조회 대상으로 선택할 수 있는 사이트 목록과 현재 선택된 사이트를 조회한다. 측정기·데이터·리포트 조회는 모두 현재 사이트를 기준으로 한다.

Inputs: no named parameters.

site_selectA

조회 대상 사이트를 바꾼다. 사이트 이름의 일부(예: '부산시설공단')만 줘도 되고, 정확한 siteId 를 줘도 된다. 이후의 모든 조회가 이 사이트 기준으로 바뀐다.

Inputs: site (required).

stat_collection_rateA

측정기 × 일자별 데이터 수집률(결측률)을 조회한다. 결측 구간 파악에 쓴다.

Inputs: end (required), start (required), maxRows, deviceId.

stat_daily_avgA

평균 데이터를 기간으로 조회한다. 1일 이하는 원시, 30일 이하는 시간평균, 초과는 일평균으로 서버가 자동 전환한다.

Inputs: endDate (required), deviceId (required), startDate (required), maxRows.

stat_weatherA

기상청 관측 이력(기온·풍향·풍속·습도 등)을 시간별 또는 일별로 조회한다.

Inputs: stnId (required), endDate (required), startDate (required), mode, +1 more.

stat_weather_stationsA

기상청(KMA) 관측소 목록을 조회한다. stat_weather 의 stnId 를 찾을 때 쓴다.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 36 tools

    Disambiguation2/5

    Multiple tools overlap in purpose, especially around data queries: data_recent vs device_realtime, monitor_search vs data_search vs data_raw_search vs stat_daily_avg, and monitor_rose vs monitor_rose_search. Descriptions clarify some differences, but several tool boundaries remain unclear and could easily cause misselection.

    Naming Consistency3/5

    Most tool names use snake_case with domain prefixes like device_, data_, stat_, correction_, report_, and monitor_, which provides structure. However, action verbs are inconsistent and some names are non-verb nouns or adjectives such as data_recent, monitor_rose, correction_factors, and report_v2_html, making the pattern less predictable.

    Tool Count2/5

    With 36 tools, the server exceeds the 25+ threshold and feels heavy. Several tools could be consolidated, such as the realtime variants, rose variants, and overlapping period-based data query tools, even though the overall domain is fairly broad.

    Completeness4/5

    The tool set gives broad read coverage for authentication, site/device context, raw and aggregated measurements, corrections, reports, and alarms. The lack of create/update/delete operations is acceptable for a monitoring-focused server, though alarm config is read-only and some reporting workflows are only partially surfaced.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      F
      maintenance
      This read-only MCP Server allows you to connect to Adobe Analytics data from Claude Desktop through CData JDBC Drivers. For full CRUD support, check out the first managed MCP platform: CData Connect AI (https://www.cdata.com/ai/).
      3
      MIT
    • A
      license
      C
      quality
      D
      maintenance
      An MCP server that provides seamless integration with Claude Desktop for querying and managing timeseries data in GigAPI Timeseries Lake.
      7
      6
      Apache 2.0
    • A
      license
      Not graded
      quality
      C
      maintenance
      MCP server for the air-Q Cloud API, enabling remote retrieval of air quality sensor data and historical analysis through read-only tools like listing devices, fetching readings, and exporting charts or data.
      49 PyPI
      Apache 2.0
    • A
      license
      A
      quality
      D
      maintenance
      Read-only MCP server enabling natural language querying of personal health and cultural activity scores from the health.ojimpo.com dashboard via Claude.
      5
      MIT