WorkBuddy 平台 · MCP 协议 · AI-Native 架构

AI-Native 企业资产管理
以 WorkBuddy 为 AI 运行基座

EAMX 作为 MCP Server 注册到 WorkBuddy — 利用其 AI 对话引擎、100+ 专家生态和 Skill 编排能力，
用户通过对话下达指令，Agent 自动调用 47 个 MCP 工具完成资产全生命周期管理。

查看 MCP 工具清单 免费试用 EAMX

快速开始

两步接入 — 配置 MCP Server，即刻通过 AI 对话管理设备资产

1
在 WorkBuddy 中配置 EAMX MCP Server
  1. 打开 WorkBuddy 桌面端，点击右上角 连接器管理（或设置 → 连接器）
  2. 选择 添加自定义 MCP Server，填入以下配置：
    名称： EAMX
    URL： https://mcp.eamx.com.cn/mcp
    类型： Streamable HTTP
    API Key： eam_sk_3N7sG6M6jb6VdvqGp0rTJDD0LXsZjanA
  3. 点击 Trust（信任） 按钮启用连接器
  4. 配置完成后，WorkBuddy 会自动发现 47 个 EAMX 工具接口
  5. 在对话中直接使用自然语言下达指令，例如：
    "帮我查一下所有在用设备的台账"
WorkBuddy 对话界面 - 通过 MCP 调用 EAMX 生成设备台账分析报告
📌 WorkBuddy 对话界面 — Agent 自动调用 EAMX MCP 工具生成设备台账分析报告
2
在 mcp.eamx.com.cn 浏览数据结果
  1. 浏览器访问 mcp.eamx.com.cn（EAMX MCP 前端只读页面）
  2. 左侧导航栏包含全部业务模块：
    资产台账、位置/部门/分类、点检保养、故障工单、主数据等
  3. 点击各模块可浏览 Agent 操作后的数据结果
    （该前端为只读，所有数据变更均由 Agent 通过 MCP 工具完成）
  4. 支持按状态、分类、位置等多维度筛选和搜索
  5. 数据实时同步自 EAMX 后端 PostgreSQL 数据库
mcp.eamx.com.cn 资产台账页面 - 只读浏览设备资产列表
📌 mcp.eamx.com.cn 资产台账页面 — 只读浏览 Agent 操作后的设备资产数据
47
MCP 工具接口
8
功能模块覆盖
9态
故障工单状态机
双Token
防 AI 编造机制

项目简介

EAMX AI-Native 架构 — Agent 是首要操作者，WorkBuddy 为运行宿主

EAMX MCP 是一套以 AI Agent 为首要操作者的企业资产管理协议接口， 2026 年 7 月全新构建，从零设计，不借鉴、不复用任何既有系统。

核心理念：95%+ 的业务操作经由 Agent 完成，人类通过与 AI 对话下达指令， AI 通过 MCP 工具操作后台系统。浏览器端仅提供只读浏览，不设任何增删改查操作界面。

EAMX MCP 运行在 WorkBuddy 平台上。WorkBuddy 是全能 AI 工作台， 定位为"AI Agent 办公新范式"——不是聊天机器人，而是让您一人指挥、全行业专家执行的平台。 内置 100+ 领域 AI 专家，支持桌面端、主流 IM 和小程序全平台覆盖。

用户打开 WorkBuddy 对话界面即可开始工作——无需学习任何系统操作，用自然语言说"3号机坏了"就能触发故障上报流程。 EAMX 作为 MCP Server 注册到 WorkBuddy，利用其对话引擎、Skill 编排和连接器管理能力，无需自建对话引擎和 Agent 框架。

后端基于 Node.js + Fastify + MCP（Streamable HTTP）+ Drizzle ORM + PostgreSQL 搭建。 采用 RBAC+ABAC 混合权限模型，支持 JWT 与 API Key 双认证。

技术栈

Technology Stack — AI-Native 架构的底层支撑

🤖
WorkBuddy
AI 对话平台，Agent 运行宿主，MCP 连接器管理
⚛️
React
前端只读 UI，shadcn/ui 组件库，响应式 PC/移动
🚀
Fastify
Node.js 后端框架，端口 3100，同源托管前端
🔌
MCP · Streamable HTTP
Model Context Protocol 工具接口，Agent 操作底座
🗄️
Drizzle ORM
类型安全的 SQL ORM，PostgreSQL 17
🐘
PostgreSQL 17
数据库，UTF8 + 中文 locale，UUID 主键 + 多租户隔离
📦
esbuild
TypeScript 打包，输出 dist/index.js
🔐
JWT + API Key
双认证，12h JWT / 长寿命永不过期机器凭证
📐
Zod
运行时参数校验，MCP 工具输入 Schema 定义

核心功能

Core Capabilities — 六大功能模块，覆盖设备管理全场景

🏗️

资产管理

设备资产台账全生命周期管理：创建、查询、信息变更、调拨、报废。资产变更一律经「单据驱动」，执行人确认后生效，全程可追溯。

🔍

点检管理

点检技术标准（含双周期）→ 计划 → 绑定设备 → 工单 → 逐项执行。支持交互卡片与临时 HTML 页面两种执行方式。

🔧

保养管理

保养技术标准（作业/工序项）→ 计划 → 工单 → 执行。支持记录更换件与费用消耗，备件消耗规范化管理。

⚠️

故障工单管理

完整 9 态状态机：上报→派单→接单→维修→提验→验收/驳回/重开/取消。支持 AI 辅助诊断，结论经对话采集由人确认。

📋

审批流

信息变更单/调拨单拟单（draft）→ 人在环审看 → 执行生效或作废。状态机：draft → executed / void，全程审计。

📊

批量导入

两阶段导入：preview 校验 + commit 写入。枚举模糊匹配交人确认，主数据引用严格解析，失败行整行拒绝。

架构设计

Architecture — 五层架构，MCP 协议贯穿全栈

用户层
WorkBuddy 对话界面
PC 浏览器（只读）
临时 HTML 页面
MCP (Streamable HTTP)
Agent 层
对话理解
意图拆解
工具编排
引用解析层
Fastify API / MCP
服务层
authz
asset.service
orders.service
om.service
import.service
resolve.service
enum.service
Drizzle ORM
数据层
PostgreSQL 17
asset
change/transfer_order
inspection/maintenance/fault
enum_value / api_key
01
MCP 工具驱动

所有业务操作封装为 MCP Tool，Agent 通过工具调用完成资产/工单/主数据操作。RBAC+ABAC 鉴权闸门在前，service 层审计在后。

02
单据驱动

资产台账变动一律经变更单/调拨单/报废单承载。execute_order 是唯一改账入口，拟单只落草稿不改台账，人在环执行。

03
双 Token 防编造

读 Token（cardToken）给 Agent 获取页面，写 Token（writeToken）仅内嵌于 HTML。Agent 无法获取写 Token，从根本上阻断编造提交。

04
引用解析层

resolve.service.ts 统一解析人类标识（编码/名称/工号）→ UUID。所有 MCP 写路径引用字段同时接受 UUID 或自然标识，内部归一。

05
WorkBuddy 深度集成

EAMX 作为 MCP Server 注册到 WorkBuddy，利用其对话能力、Skill 编排、连接器管理、用户鉴权等平台能力，无需自建对话引擎。

WorkBuddy 平台：EAMX 的 AI 运行基座

EAMX 以 WorkBuddy 为运行宿主，利用其 AI 对话引擎、100+ 专家生态、MCP 连接器管理和 Skill 编排能力，实现 AI-Native 的设备资产管理

🤖 什么是 WorkBuddy？

WorkBuddy 是全能 AI 工作台，定位为"AI Agent 办公新范式"。它不是一个聊天机器人， 而是一个可以让您一人指挥、全行业专家执行的 AI 平台。

100+ 领域专家组成您的虚拟团队，覆盖运营、设计、数据、开发等全角色场景。 EAMX 作为 MCP Server 注册到 WorkBuddy，利用其对话引擎、Skill 编排 和连接器管理能力，无需自建对话引擎和 Agent 框架。

一句话指令，WorkBuddy 自主规划并交付完整结果。 多专家并行协作，一个人顶一支团队。

100+
领域 AI 专家
免部署
安装即用
全平台
桌面/IM/小程序
🧠

AI 专家团 · 全场景办公

WorkBuddy 内置 100+ 领域专家，覆盖产品经理、架构师、工程师、设计师、运营等全角色。EAMX 设备管理 Agent 作为"工业领域专家"加入团队，用户通过自然语言指挥即可完成复杂任务。

🔌

MCP 生态 · 无限扩展

WorkBuddy 原生支持 MCP（Model Context Protocol）协议。EAMX 以 MCP Server 形式注册，其 47 个资产/工单/数据工具对 AI Agent 开放调用。您还可以接入其他 MCP 服务，构建专属 AI 工作流。

⚙️

自定义 Skills · 流程编排

WorkBuddy Skill 机制将复杂业务流程封装为可复用模版。EAMX 故障工单 13 步全流程就是典型的 Skill。从故障上报、派单、接单到维修、提验、关闭，Agent 按规范自动推进。

🛡️

安全护栏 · 人在环

WorkBuddy 的连接器管理和对话确认机制，确保每步敏感操作都经过人确认。资产改账、工单推进等操作必须经 WorkBuddy 对话确认后 Agent 才能执行，从架构上阻断 AI 擅自操作。

💬

对话即操作

用户不需要学习任何系统界面，打开 WorkBuddy 用自然语言说"3号机坏了"即可完成故障上报。Agent 在后台自动调用 MCP 工具执行，用户全程通过对话驱动。

🏢

OPC 一人公司模式

WorkBuddy 支持"一人公司"模式，个体创业者或小微团队可召唤 AI 专家团覆盖运营、设计、财务、法务、开发等岗位。EAMX 设备管理能力天然融入这个生态。

MCP 工具清单

共 47 个 MCP 工具，覆盖资产、主数据、枚举、点检、保养、故障、通用等八大模块

6 工具

🏗️ 资产模块

asset
asset_create
创建设备资产台账条目，自动生成 AST-YYYYMM-XXXXXX 编码
asset
asset_get
获取单条资产详情（UUID 或 资产编码）
asset
asset_list
分页查询资产台账，按状态/分类/位置/编码过滤
asset
asset_change
拟信息变更单（草稿），变更多个资产字段后需 execute_order 生效
asset
create_transfer_order
拟调拨单·主子表批量，同时变动位置/部门/责任人，需 execute_order 生效
asset
asset_import
两阶段批量导入：preview 校验 + commit 正式写入，含枚举模糊匹配
3 工具

📋 单据模块

order
execute_order
执行草稿单据（唯一改台账入口），据快照改 asset + 写变更明细 + 审计
order
void_order
作废草稿单据（仅 draft 可作废）
order
list_orders
查询单据列表，按类型与状态过滤（draft/executed/void）
6 工具

📁 主数据模块

master
master_create
创建主数据：位置/部门/分类/人员/制造商/供应商
master
master_update
更新主数据指定字段（受白名单约束）
master
master_move
移动树形主数据节点，自动维护物化路径
master
master_get
获取单条主数据详情
master
master_list
分页/按父级列出主数据
master
master_tree
获取整棵主数据树（location/department/category）
5 工具

🏷️ 枚举模块

enum
enum_type_create
创建枚举类型（如 status/change_type）
enum
enum_value_create
创建枚举值（code/label/审批规则）
enum
enum_value_update
更新枚举值（改名/启用禁用/审批规则）
enum
enum_value_delete
删除枚举值（system_protected 拒绝删除）
enum
enum_list
列出枚举类型或指定类型的值列表
12 工具

🔍 点检模块

inspection
inspection_standard_create
创建点检技术标准（测量/观测项集合，含双周期）
inspection
inspection_standard_update
原地更新点检标准（保留 ID，不破坏引用）
inspection
inspection_standard_list
查询点检标准列表（按编码/名称筛选）
inspection
inspection_standard_get
获取点检标准详情（含全部检查项）
inspection
inspection_plan_create
创建点检计划（引用标准，按资产/列表/位置排程）
inspection
inspection_plan_derive
从标准按「角色×周期」派生产计划，可选绑定设备
inspection
inspection_plan_bind_assets
绑定/追加设备到已有计划（set/add 模式）
inspection
inspection_plan_list
查询点检计划列表（多维度筛选）
inspection
inspection_plan_get
获取计划详情（含绑定设备清单）
inspection
inspection_order_create
拟点检工单（draft），可预填标准项
inspection
inspection_order_get_item
逐项获取点检项（一次只返回一项，强制逐项交互）
inspection
inspection_execute_card
获取点检卡片数据（含双 Token），用于 show_widget 交互
9 工具

🔧 保养模块

maintenance
maintenance_standard_create
创建保养技术标准（作业/工序项集合）
maintenance
maintenance_standard_update
原地更新保养标准（保留 ID）
maintenance
maintenance_standard_list
查询保养标准列表
maintenance
maintenance_standard_get
获取保养标准详情（含全部作业项）
maintenance
maintenance_plan_create
创建保养计划
maintenance
maintenance_plan_list
查询保养计划列表
maintenance
maintenance_plan_get
获取保养计划详情
maintenance
maintenance_order_create
拟保养工单（draft），可预填作业项
maintenance
maintenance_order_execute
执行保养工单，记录更换件与费用
5 工具

⚠️ 故障模块

fault
fault_catalog_create
创建故障目录/知识库条目
fault
fault_catalog_list
查询故障目录/知识库列表
fault
fault_catalog_get
获取故障目录条目详情（含症状/建议处理）
fault
fault_order_create
上报故障→拟故障工单，自动置设备状态为"故障中"
fault
fault_order_transition
推进故障工单 9 态状态机（唯一能改 device_status 的入口）
4 工具

🔄 通用模块

om
om_list
只读浏览运维工单（按 module/status/assetId 过滤）
om
om_get
查看单张运维工单详情（含扩展信息/资产/标准名）
om
spare_parts_summary
汇总备件消耗（按名称聚合总量/总成本/工单数）
om
inspection_submit_from_temp
从临时点检页面暂存结果中正式提交工单

共计 47 个 MCP 工具 · 覆盖资产、主数据、枚举、点检、保养、故障、通用操作

设计原则

Design Principles — AI-Native 范式下的核心约束

01
AI-Native 范式

系统以 Agent 为首要操作者，95%+ 业务操作经由 AI 完成。Agent 通过 MCP 工具操作后台，人类通过 WorkBuddy 对话下达指令。浏览器端仅提供只读浏览，不设 CRUD 操作界面。

02
人在环（Human-in-the-Loop）

execute_order 是唯一改台账入口，拟单只落草稿不改账。Agent 不得自动连调 execute_order，必须等待人口头或界面确认后才执行。故障结论字段禁止 Agent 自行编造，须经 WorkBuddy 对话逐项询问。

03
不建 PC 编辑入口

凡需要现场专业判断/须人负责的"结论字段"（故障处理措施/故障原因/人工时/点检结果），一律不开发 PC 端表单/编辑页。正确做法：Agent 在 WorkBuddy 对话中逐项询问，工具描述严禁 Agent 编造。

04
对话采集

需用户录入的数据优先用"对话逐项询问 + MCP 提交"模式。用户通过 WorkBuddy 自然语言提供信息，Agent 摘取后回显确认，确认后再写入。可生成临时 HTML 页面让用户直接操作，更防编造。

05
单据驱动

资产台账的所有变动必须经过变更单/调拨单/报废单承载。拟单只落 draft 不改台账，execute_order 是唯一改账入口，写入 asset_change 明细 + audit_log，全程可追溯。

06
平台即安全

WorkBuddy 提供不可绕过的对话确认机制，所有敏感操作必须经 WorkBuddy 对话确认后 Agent 才能执行。双 Token 分离：读 Token 给 Agent 获取页面，写 Token 仅内嵌于 HTML，Agent 无法获取。confirmedByUser + 一次性 human_token 双重校验，从架构上阻断 Agent 自行编造数据提交。

开发历程

Development Timeline — 从零构建 AI-Native EAM 系统

2026-07-13
项目启动
完全全新构建，从零设计。确定 Agent 优先架构：Agent 是首要操作者，人类通过 WorkBuddy 对话交互，浏览器只读。
2026-07-14
单据驱动落地
资产变更从直接改账改为「单据驱动」。createChangeOrder 只落 draft 不改台账，executeOrder 是唯一改账入口。
2026-07-15
权限 + 批量导入
RBAC+ABAC 混合权限模型落地，JWT 与 API Key 双认证。两阶段资产批量导入（preview + commit）实现。
2026-07-16
点检双周期模型
确定点检周期模型：标准层不按周期拆分，周期作为项属性。计划层按「角色×周期」组合派生。
2026-07-17
引用解析全场景落地
resolve.service.ts 统一解析人类标识 → UUID，砍掉 Agent 全量翻页枚举的低效查询。
2026-07-18
交互范式拍板
结论字段不开发 PC 端表单/编辑页，走 WorkBuddy 对话逐项询问 + MCP 提交。
2026-07-20
点检交互卡片 + 双 Token + 故障工单全流程
inspection_execute_card 落地，confirmedByUser + human_token 双 Token 从架构防 AI 编造。WorkBuddy Skill 实现故障工单 13 步全流程自动化。
2026-07-21
WorkBuddy 深度集成
fault_ai_analyze MCP 工具上线，后端调 LLM 分析故障后通过 WorkBuddy 回传结果。双 Token 防 AI 编造方案经 WorkBuddy 对话机制落地。

体验 AI-Native 的设备资产管理

EAMX 运行在 WorkBuddy 平台上 — 下载 WorkBuddy 桌面端，连接 EAMX MCP Server，即刻开启对话驱动的设备管理

下载 WorkBuddy → 免费注册 EAMX