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 是仅允许本次执行未签名脚本的选项。
不会更改系统策略。
安装脚本的工作内容(通用)
服务器地址固定为运营服务器(https://monitor.arimair.com),不会询问。
两个脚本都只询问用户名、密码和账户类型,然后注册到以下两个位置。
Claude Code CLI (
claude mcp add arim -s user) — 如果没有claude命令则跳过Claude Desktop 配置文件 — 将现有文件备份为
.bak.<타임스탬프>,保留已注册的其他 MCP 服务器
操作系统 | 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
环境变量
变量 | 默认值 | 说明 |
|
| 目标服务器地址。安装脚本已固定注册为此值,平时无需修改,仅在连接本地服务器测试时改为 |
| — | 自动登录用户名 |
| — | 自动登录密码 |
|
|
|
|
| 请求超时时间(毫秒) |
如果将凭据放入环境变量,首次调用工具时会自动登录,会话过期后会重新登录一次并重试。
认证方式
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)
普通用户账户只能查看已获批准的供应商,管理员账户可查看完整列表(与网页规则相同)。
工具列表
认证
工具 | 说明 |
| 登录(可使用环境变量凭据) |
| 查询登录状态 / monitorId / 系统设置 |
| 结束会话 |
站点
工具 | 说明 |
| 可选站点列表及当前站点 |
| 更改查询目标站点 |
测量仪
工具 | 说明 |
| 测量仪列表 |
| 测量仪详情 |
| 所有测量仪最新值(原始) |
| 所有测量仪最新值(已应用校准) |
| 附近 에어코리아 监测站 |
测量数据
工具 | 说明 |
| 期间查询(按期间自动切换原始/小时平均/日平均) |
| 始终按分钟查询原始数据 |
| 最近采集的数据 |
统计·气象
工具 | 说明 |
| 查询平均数据 |
| 测量仪 × 按日期的采集率(缺失率) |
| KMA 观测站列表 |
| KMA 观测历史(按小时/按日) |
| 传感器元数据(单位·小数位数) |
校准
工具 | 说明 |
| 校准目标测量仪及应用现状 |
| 校准因子趋势(最近 12 个月) |
| 校准前/后时间序列对比 |
| 特定应用月份的校准因子 |
| 校准模型版本历史 |
报告
工具 | 说明 |
| 发布历史 |
| 历史详情 |
| 发布目标月份列表 |
| 新报告(V2)HTML 正文 |
警报
工具 | 说明 |
| 警报发生历史 |
| 传感器阈值短信通知设置 |
监控汇总
工具 | 说明 |
| 运行/通信状态汇总 |
| 正常运行率 |
| 采集数量汇总 |
| 故障·异常测量仪 |
| 查询监控基准期间 |
| 污染玫瑰图 |
大量响应处理
时间序列查询工具接收 maxRows(默认 500)。服务器没有行数上限,仅查询一天的分钟级数据就会产生
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