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 / 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 + 会话 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）

普通用户账户只能查看已获批准的供应商，管理员账户可查看完整列表（与网页规则相同）。

工具列表

认证

站点

测量仪

测量数据

统计·气象

校准

报告

警报

监控汇总

大量响应处理

时间序列查询工具接收 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）。