Skip to main content
Glama

ARIM MCPサーバー

アリムエア監視システムの測定データ・統計・補正・レポートをClaudeから直接照会するMCP(stdio)サーバー。

照会専用です。 サーバー状態を変更する機能(レポート発行、補正適用、デバイスコマンド、バックフィル、アラーム登録/削除)は含みません。

インストール

Node.js 18以上が必要です。

macOS / Linux

cd /Users/amdmania/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は、署名されていないスクリプトの実行を今回の1回だけ許可するオプションです。 システムポリシーは変更しません。

インストールスクリプトが行うこと(共通)

サーバーアドレスは運用サーバー(https://monitor.arimair.com)に固定されているため、確認は行いません。 両スクリプトともID・パスワード・アカウント種別のみを確認し、以下の2箇所に登録します。

  • 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/amdmania/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

—

自動ログインID

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(モニタリング対象管理者アカウント)ですが、ツールでは「サイト」として扱います。 Web画面上部のサイト選択コンボと同じものです。

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

site_selectはサイト名の一部だけでも構いません。登録名と言葉の順序が異なっていても(例: 登録名が [環境保健センター] 蔚山 蔚山大学)、単語がすべて含まれていれば検索します。表示名(company)と担当者名(name)、 siteIdのすべてを対象に検索します。

  • 候補が複数ある場合は任意に選ばず、候補リストを返します (例: 「環境保健センター」→ 9件)

  • 完全一致の名前があれば部分一致より優先します (例: 「道路交通研究院」→ arimsc_ex)

一般ユーザーアカウントは承認済みプロバイダーのみ、管理者アカウントは全リストを表示します (Web画面と同じルール)。

ツール一覧

認証

ツール

説明

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

センサー閾値SMS通知設定

モニタリング集計

ツール

説明

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