维护X MCP服务器
MCP（模型上下文协议）服务器 维护X CMMS API。该服务器使Claude等AI助手能够与MaintainX交互，以管理工单、资产、维护操作等。
特性
- 工作指令：创建、更新、完成和列出工作订单
- 资产：管理实物资产和设备
- 工作请求：处理收到的维护请求
- 位置：按物理位置组织资产
- 零件和库存：跟踪零件和库存水平
- 用户和团队：访问组织成员和团队
- 米：记录和跟踪仪表读数
- 供应商：管理供应商关系
- 采购订单：查看采购信息
- 程序模板：访问标准化维护程序
安装
使用npx（推荐）
npx maintainx-mcp-server
手动安装
npm install -g maintainx-mcp-server
配置
环境变量
将MaintainX API键设置为环境变量：
export MAINTAINX_API_KEY=your_api_key_here
对于多组织帐户，可以选择设置：
export MAINTAINX_ORGANIZATION_ID=your_org_id
获取API密钥
- 登录您的MaintainX帐户
- 首选 设置 > 集成 > API密钥
- 生成新的API密钥
Claude桌面配置
添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"maintainx": {
"command": "npx",
"args": ["-y", "maintainx-mcp-server"],
"env": {
"MAINTAINX_API_KEY": "your_api_key_here"
}
}
}
}
可用工具
工作指令
| 工具 | 说明 |
|---|
list_work_orders | 列出带有过滤器的工作订单（状态、优先级、受让人等） |
get_work_order | 获取详细的工单信息 |
create_work_order | 创建新的工单 |
update_work_order | 更新现有工单 |
complete_work_order | 将工单标记为已完成 |
资产
| 工具 | 说明 |
|---|
list_assets | 列出带有过滤器的资产 |
get_asset | 获取详细的资产信息 |
create_asset | 创建新资产 |
update_asset | 更新现有资产 |
工作请求
| 工具 | 说明 |
|---|
list_work_requests | 列出工作请求 |
get_work_request | 获取工作请求详细信息 |
create_work_request | 提交新的工作请求 |
approve_work_request | 批准工作请求 |
decline_work_request | 拒绝工作请求 |
位置
| 工具 | 说明 |
|---|
list_locations | 列出地点 |
get_location | 获取位置详细信息 |
create_location | 创建新位置 |
update_location | 更新位置 |
用户和团队
| 工具 | 说明 |
|---|
list_users | 列出组织用户 |
get_user | 获取用户详细信息 |
list_teams | 列出团队 |
get_team | 获取团队详细信息 |
零件和库存
| 工具 | 说明 |
|---|
list_parts | 列出带有可选低库存过滤器的零件 |
get_part | 获取零件详细信息 |
create_part | 创建新零件 |
update_part | 更新零件 |
adjust_part_quantity | 调整库存数量 |
米
| 工具 | 说明 |
|---|
list_meters | 列出仪表 |
get_meter | 获取仪表详细信息 |
create_meter_reading | 记录仪表读数 |
list_meter_readings | 列出仪表的读数 |
供应商
| 工具 | 说明 |
|---|
list_vendors | 列出供应商 |
get_vendor | 获取供应商详细信息 |
create_vendor | 创建新供应商 |
采购订单
| 工具 | 说明 |
|---|
list_purchase_orders | 列出采购订单 |
get_purchase_order | 获取采购订单详细信息 |
程序模板
| 工具 | 说明 |
|---|
list_procedure_templates | 列出程序模板 |
get_procedure_template | 获取程序模板详细信息 |
用法示例
配置后，您可以要求Claude：
- “显示所有未结工单”
- “创建主楼暖通空调维护工单”
- “列出当前脱机的所有资产”
- “哪些零件库存不足？”
- “记录123号资产5000小时的仪表读数”
- “谁被分配到456号工单？”
速率限制
MaintainX API具有以下速率限制：
- 每60秒100个请求 每用户
- 每60秒500个请求 每个组织
当超过速率限制时，服务器将返回相应的错误消息。
发展
从源头构建
git clone https://github.com/yourusername/maintainx-mcp-server.git
cd maintainx-mcp-server
npm install
npm run build
在发展中奔跑
npm run dev
许可证
MIT许可证-请参阅 许可证 了解详情。
链接
