AI导哈

维护管理服务器

Atlas CMMS MCP Server是一个维护管理服务器，提供15个参数化工具，涵盖194种操作，用于工单、资产、预防性维护、计量、部件、采购订单、位置、供应商、团队、任务、请求、成本、分析、文件和系统管理。

  • by hvkshetry
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 hvkshetry/atlas-cmms-mcp

使用说明

Atlas CMMS MCP服务器

MCP服务器 阿特拉斯CMMS （Grashjs）维护管理。提供15个参数化工具，涵盖194个操作，包括工单、资产、预防性维护、仪表、零件、采购订单、位置、供应商、团队、任务、请求、成本、分析、文件和系统管理。

需求

  • Python 3.11+
  • 紫外线 （推荐）或pip
  • Atlas CMMS（Grashjs）实例
  • 管理员用户凭据（电子邮件/密码）

设置

# Clone the repository
git clone https://github.com/puran-water/atlas-cmms-mcp.git
cd atlas-cmms-mcp

# Copy the example environment file and fill in your values
cp .env.example .env

# Install dependencies
uv sync

编辑 .env 使用您的Atlas CMMS实例URL和凭据：

ATLAS_URL=https://your-atlas-cmms-instance.example.com
ATLAS_EMAIL=admin@example.com
ATLAS_PASSWORD=your-password-here

用法

STDIO模式（默认）

uv run python server.py

SSE模式（HTTP传输）

uv run python server.py sse --port 3075

克劳德桌面/MCP客户端配置

添加到MCP客户端配置中（例如。 ~/.claude/mcp.json):

{
  "mcpServers": {
    "atlas-cmms-mcp": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/atlas-cmms-mcp", "python", "server.py"],
      "env": {
        "ATLAS_URL": "https://your-atlas-cmms-instance.example.com",
        "ATLAS_EMAIL": "admin@example.com",
        "ATLAS_PASSWORD": "your-password-here"
      }
    }
  }
}

或者对于SSE运输：

{
  "mcpServers": {
    "atlas-cmms-mcp": {
      "url": "http://localhost:3075/sse"
    }
  }
}

工具

每个工具都使用参数化 operation 字段以选择特定操作。

工具 操作 说明
work_order 20 工单生命周期（搜索、创建、状态更改、历史、类别）
asset 18 资产层次结构、跟踪、停机时间、NFC/条形码查找
preventive_maintenance 14 PM时间表，基于仪表的触发器
cmms_part 15 零件库存、数量、多零件装配
cmms_purchase_order 8 采购订单分类管理
meter 10 仪表、读数、状态监测
location 11 带平面图的位置层次结构
vendor 10 供应商和客户管理
team 12 团队、用户和角色管理
task 12 工单任务和可重复使用的检查表
request 8 具有审批工作流的工单请求
cost 10 劳动力跟踪和额外成本管理
analytics 20 关键绩效指标：MTBF、MTTR、WO统计、资产绩效、成本
file 11 文件上传/下载、导入/导出（WO、资产、零件）
system 15 身份验证、公司设置、首选项、货币、自定义字段

API注释

  • 认证：以智威汤逊为基础。服务器使用提供的凭据自动登录，并在401响应中刷新令牌。
  • 搜索模式：所有列表端点都使用 POST /search 带着一个 SearchCriteria 身体包含 filterFields, pageNum, pageSize, sortField，以及 direction.
  • 许可证封闭式运营：一些操作（供应商/客户创建、劳动力/成本跟踪、资产停机时间、文件上传、WO链接）需要有效的Atlas CMMS许可证。这些返回403，但后端没有配置有效的许可证密钥。

建筑

  • server.py --配备15个参数化工具和双传输（STDIO/SSE）的FastMCP服务器
  • client.py --异步HTTP客户端使用具有JWT身份验证的aiohttp，在401上自动刷新，以及标准的Grashjs搜索模式

许可证

麻省理工学院

相关 MCP