arimair-mcp
OfficialARIM 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 |
|
Windows |
|
登録後、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
環境変数
変数 | デフォルト値 | 説明 |
|
| 対象サーバーアドレス。インストールスクリプトがこの値で固定登録するため通常は触る必要がなく、ローカルサーバーに接続してテストするときだけ |
| — | 自動ログインID |
| — | 自動ログインパスワード |
|
|
|
|
| リクエストタイムアウト(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画面と同じルール)。
ツール一覧
認証
ツール | 説明 |
| ログイン (環境変数の資格情報を使用可能) |
| ログイン状態 / monitorId / システム設定照会 |
| セッション終了 |
サイト
ツール | 説明 |
| 選択可能なサイト一覧と現在のサイト |
| 照会対象サイトの変更 |
測定器
ツール | 説明 |
| 測定器一覧 |
| 測定器詳細 |
| 全測定器の最新値 (生データ) |
| 全測定器の最新値 (補正適用) |
| 近隣のエアコリア測定所 |
測定データ
ツール | 説明 |
| 期間照会 (期間別の生データ/時間平均/日平均を自動切替) |
| 常に分単位の生データを照会 |
| 最近の収集データ |
統計・気象
ツール | 説明 |
| 平均データ照会 |
| 測定器 × 日別収集率(欠測率) |
| KMA観測所一覧 |
| KMA観測履歴 (時間別/日別) |
| センサーメタ (単位・小数桁数) |
補正
ツール | 説明 |
| 補正対象測定器および適用状況 |
| 補正係数の推移 (直近12ヶ月) |
| 補正前/後の時系列比較 |
| 特定適用月の補正係数 |
| 補正モデルバージョン履歴 |
レポート
ツール | 説明 |
| 発行履歴 |
| 履歴詳細 |
| 発行対象月一覧 |
| 新レポート(V2) HTML本文 |
アラーム
ツール | 説明 |
| アラーム発生履歴 |
| センサー閾値SMS通知設定 |
モニタリング集計
ツール | 説明 |
| 稼働/通信状態集計 |
| 正常稼働率 |
| 収集件数集計 |
| 故障・異常測定器 |
| モニタリング基準期間照会 |
| 汚染風配図 |
大量応答処理
時系列照会ツールはmaxRows(デフォルト500)を受け取ります。サーバーには行数上限がないため、1日分の分単位照会だけでも
1,400行以上になることがあり、超過時は等間隔サンプリングし、応答にtotalRows / returnedRows / sampledを
併せて返します。最後(最新)の行は常に保持します。
サーバー側の依存事項
このMCPは以下のサーバー変更を前提とします。
位置 | 変更 |
|
|
|
|
|
|
/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 toolsalarm_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_raw_searchA
기간과 무관하게 항상 분단위 원시 데이터를 조회한다. 통계 테이블을 거치지 않는다.
Inputs: endDate (required), deviceId (required), startDate (required), maxRows.
data_recentB
측정기의 최근 수집 데이터를 조회한다.
Inputs: deviceId (required), maxRows.
data_searchB
측정 데이터를 기간으로 조회한다. 조회 기간에 따라 서버가 단위를 자동 전환한다 (1일 이하: 분단위 원시, 30일 이하: 시간평균, 초과: 일평균).
Inputs: endDate (required), deviceId (required), startDate (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_rose_searchC
지정 기간의 오염장미도 데이터를 조회한다.
Inputs: endDate (required), startDate (required).
monitor_searchC
모니터링 화면과 동일한 기준으로 측정기의 기간별 데이터를 조회한다.
Inputs: endDate (required), deviceId (required), startDate (required), maxRows.
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
Scored across 36 tools
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.
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.
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.
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
Related MCP Connectors
Read-only MCP server for AIStatusDashboard status, incidents, metrics, and fallback recommendations.
Read-only MCP server for The Quiet Protocol's engines, benchmarks, proof, and business data.
Read-only Google Analytics 4 MCP server for AI assistants.
Read-only MCP server for ClassQuill, a tutoring-business-management platform.
Related MCP Servers
- AlicenseNot gradedqualityFmaintenanceThis 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/).3MIT
- AlicenseCqualityDmaintenanceAn MCP server that provides seamless integration with Claude Desktop for querying and managing timeseries data in GigAPI Timeseries Lake.76Apache 2.0
- AlicenseNot gradedqualityCmaintenanceMCP 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 PyPIApache 2.0
- AlicenseAqualityDmaintenanceRead-only MCP server enabling natural language querying of personal health and cultural activity scores from the health.ojimpo.com dashboard via Claude.5MIT