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 是仅允许本次执行未签名脚本的选项。 不会更改系统策略。

安装脚本的工作内容(通用)

服务器地址固定为运营服务器(https://monitor.arimair.com),不会询问。 两个脚本都只询问用户名、密码和账户类型,然后注册到以下两个位置。

  • Claude Code CLI (claude mcp add arim -s user) — 如果没有 claude 命令则跳过

  • Claude Desktop 配置文件 — 将现有文件备份为 .bak.<타임스탬프>,保留已注册的其他 MCP 服务器

操作系统

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

—

自动登录用户名

ARIM_MCP_PASS

—

自动登录密码

ARIM_MCP_USER_TYPE

admin

admin 或 user

ARIM_API_TIMEOUT

20000

请求超时时间(毫秒)

如果将凭据放入环境变量,首次调用工具时会自动登录,会话过期后会重新登录一次并重试。

认证方式

ARIM 服务器不签发 JWT,而是通过 HttpSession + 会话 Cookie(Spring Session 的 SESSION)进行认证。 MCP 会保存通过 /account/login 调用获得的 Cookie,并在后续请求中携带。

所有请求都会附带 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,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