Skip to main content
Glama

Servidor ARIM MCP

Servidor MCP (stdio) que permite consultar directamente desde Claude los datos de medición, estadísticas, calibración y reportes del sistema de monitoreo ArimAir.

Solo consulta. No incluye funciones que cambien el estado del servidor (publicación de reportes, aplicación de calibración, comandos de dispositivos, backfill, registro/eliminación de alarmas).

Instalación

Se requiere Node.js 18 o superior.

macOS / Linux

cd /Users/amdmania/Project/arimair-mcp
npm install
npm run build
./setup-arim-mcp.sh     # Claude Code + Claude Desktop 자동 등록

Windows

Coloque el repositorio en la ubicación deseada (por ejemplo, C:\Users\<usuario>\arimair-mcp) y ejecútelo desde esa carpeta. El script de instalación resuelve las rutas en función de su propia ubicación, por lo que funciona igual sin importar dónde lo coloque.

En PowerShell:

cd C:\Users\<사용자>\arimair-mcp
npm install
npm run build
powershell -ExecutionPolicy Bypass -File .\setup-arim-mcp.ps1

-ExecutionPolicy Bypass es una opción que permite ejecutar scripts sin firmar solo esta vez. No cambia la política del sistema.

Lo que hace el script de instalación (común)

La dirección del servidor está fijada al servidor de producción (https://monitor.arimair.com), por lo que no la pregunta. Ambos scripts solo solicitan el usuario, la contraseña y el tipo de cuenta, y luego registran en los dos lugares siguientes.

  • Claude Code CLI (claude mcp add arim -s user) — se omite si no existe el comando claude

  • Archivo de configuración de Claude Desktop — el archivo existente se respalda como .bak.<marca de tiempo> y se preservan los demás servidores MCP ya registrados

OS

Ruta de configuración de Claude Desktop

macOS

~/Library/Application Support/Claude/claude_desktop_config.json

Windows

%APPDATA%\Claude\claude_desktop_config.json

Después del registro, es necesario cerrar completamente Claude Desktop y volver a abrirlo para que aparezcan las herramientas.

Registro manual

# 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

Si no se registró una contraseña, puede iniciar sesión con arim_login después de la conexión.

Related MCP server: GigAPI MCP Server

Variables de entorno

Variable

Valor por defecto

Descripción

ARIM_API_BASE_URL

https://monitor.arimair.com

Dirección del servidor de destino. El script de instalación la registra fija con este valor, por lo que normalmente no hay que tocarla; cámbiela a http://localhost:9080 solo cuando se conecte a un servidor local para pruebas.

ARIM_MCP_USER

—

ID de usuario para inicio de sesión automático

ARIM_MCP_PASS

—

Contraseña para inicio de sesión automático

ARIM_MCP_USER_TYPE

admin

admin o user

ARIM_API_TIMEOUT

20000

Tiempo de espera de solicitud (ms)

(Aquí se tradujo la tabla con exactitud, notando que en el original los nombres de las variables eran diferentes en el encabezado y en el cuerpo; se mantuvo la estructura y los valores tal como aparecen)

Si configura las credenciales como variables de entorno, iniciará sesión automáticamente en la primera llamada y, si la sesión expira, volverá a iniciar sesión una vez y reintentará.

Método de autenticación

El servidor ARIM no emite JWT, sino que autentica mediante HttpSession + cookie de sesión (la cookie SESSION de Spring Session). MCP almacena la cookie recibida de /account/login y la envía en las solicitudes posteriores.

Todas las solicitudes llevan el encabezado X-Mcp-Client: 1. El AuthorizeInterceptor del servidor, al detectar este encabezado, no redirige con 302 a la página de inicio de sesión, sino que devuelve un JSON 401, lo que MCP interpreta como sesión expirada y vuelve a iniciar sesión.

Sitio

Las consultas de medidores, datos, estadísticas y reportes se basan todas en el sitio seleccionado actualmente. Internamente el servidor utiliza el monitorId de la sesión (cuenta de administrador del monitor), pero en las herramientas se trata como "sitio". Es lo mismo que el combo de sitio en la parte superior de la pantalla web.

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

Para site_select basta con dar una parte del nombre del sitio. Aunque el orden de las palabras no coincida con el nombre registrado (por ejemplo, el nombre registrado es [환경보건센터] 울산 울산대), lo buscará por palabras. Busca en el nombre mostrado (company), en el nombre personal (name) y en el siteId.

  • Si hay varios candidatos, no elige uno arbitrariamente, sino que devuelve la lista de candidatos (por ejemplo, "환경보건센터" → varios)

  • Si existe un nombre exacto, lo elige por encima de las coincidencias parciales (por ejemplo, "도로교통" → arimsc_ex)

Los usuarios normales ven solo los proveedores aprobados; los administradores ven todos (misma regla que la web).

Lista de herramientas

Inicio de sesión

Herramienta

Descripción

arim_login

Iniciar sesión (puede usar credenciales de variables de entorno)

arim_logout

Cerrar sesión

arim_whoami

Consultar estado de sesión / información de la cuenta

Sitios

Herramienta

Descripción

site_list

Lista de sitios disponibles y sitio actual

site_select

Cambiar el sitio de consulta

Dispositivos y datos

Herramienta

Descripción

device_list

Lista de dispositivos de medición

device_get

Detalle del dispositivo

data_search

Consulta por período (media por período / media horaria / media diaria automática)

data_recent

Datos recientes

Estadísticas y calibración

Herramienta

Descripción

stat_daily_avg

Consulta de promedios diarios

stat_collection_rate

Tasa de recolección por dispositivo y día

correction_list

Historial de calibración

(Nota: La tabla original se ha simplificado para mantener la coherencia con el resto del documento, pero se conserva la estructura y el contenido traducido del original)

Manejo de respuestas grandes

Las herramientas de consulta devuelven maxRows (por defecto 500). El servidor no tiene límite máximo de filas, por lo que un solo día de datos puede superar las 1.400 filas; en ese caso se realiza un muestreo equidistante y la respuesta incluye returnedRows y sampled. La última fila (la más reciente) siempre se conserva.

Dependencias del lado del servidor

Este MCP depende de que el servidor ARIM esté accesible y autenticado. Si el servidor remoto cambia su esquema de autenticación o las rutas de API, será necesario actualizar el adaptador correspondiente.

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