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サーバーは保持します

登録後、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ツールでログインできます。

環境変数

資格情報を環境変数に設定しておくと、最初のツール呼び出し時に自動ログインし、セッションが期限切れになると一度再ログインしてから再試行します。

認証方式

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画面と同じルール)。

ツール一覧

認証

サイト

測定器

測定データ

統計・気象

補正

レポート

アラーム

モニタリング集計

大量応答処理

時系列照会ツールは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)のみを使用します。