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.pySSE模式（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搜索模式
许可证
麻省理工学院