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

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.

Variables de entorno

(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

Sitios

Dispositivos y datos

Estadísticas y 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.