# @assetlab/mcp-server 中文文档

规范地址：https://npmcn.com/package/%40assetlab/mcp-server/

版本：3\.3\.0
npm 元数据更新时间：2026-10-22T05:39:34.825Z
中文译文更新时间：2026-11-07T00:22:23.413Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40assetlab/mcp-server
原文对照：https://npmcn.com/package/%40assetlab/mcp-server/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：617 kB，25 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=20
- 运行依赖：2 个
- 首次发布：2026-03-17T02:16:51.536Z
- 最新版本发布：2026-10-22T05:39:34.643Z
- 近 30 天下载量：2783（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：77（近 12 个月 77 个）

## 中文简介

AssetLab 的 MCP 服务器 — 将 Claude 或 ChatGPT 连接到您的资产管理数据

## 安装

```sh
npm install @assetlab/mcp-server
```

也可以使用：`pnpm add @assetlab/mcp-server`、`yarn add @assetlab/mcp-server`、`bun add @assetlab/mcp-server`

## README

# 资产列表 MCP 服务器

[![npm version](https://img.shields.io/npm/v/%40assetlab%2Fmcp-server?color=cb3837&logo=npm)](https://www.npmjs.com/package/@assetlab/mcp-server) [![weekly downloads](https://img.shields.io/npm/dw/%40assetlab%2Fmcp-server?color=blue)](https://www.npmjs.com/package/@assetlab/mcp-server) [![types](https://img.shields.io/badge/types-included-3178c6?logo=typescript&logoColor=white)](https://www.npmjs.com/package/@assetlab/mcp-server) [![license](https://img.shields.io/npm/l/%40assetlab%2Fmcp-server?color=green)](https://opensource.org/licenses/MIT)

**跟你的资产谈谈.** 连接 Claude, ChatGPT, 微软副驾驶, 或任何 MCP 兼容客户端到您的 [资产列表](https://assetlab.ca/) 通过账户 [示范背景协议](https://modelcontextprotocol.io/) - 问工作订单,首相 时间表、基本建设计划和基础设施网络,以及 更新无手记录.

> **480个+工具** 纵横 **100+资源** 范围、租户范围、审计情况 读取 _财务报告和审定财务报表_ 写作 \* 主机或本地

* * *

## 快开始

### Claude.ai(主办 -- -- 最容易)

1.  在其中创建 API 密钥 **资产列表 设置 API 密钥**
2.  在克洛德艾语中: **设置 – 连接器 – 添加连接器**
3.  粘贴连接器 URL : `https://mcp.assetlab.ca`
4.  当提醒认证时, 粘贴您的 API 密钥( W)`al_live_...`(中文(简体) )

### 聊天游戏

1.  在其中创建 API 密钥 **资产列表 设置 API 密钥**
2.  在 ChatGPT 中: **设置 – Apps 连接器 – 添加新连接器**
3.  取名( 如 . `AssetLab`)并输入服务器 URL: `https://mcp.assetlab.ca`
4.  设置认证到 **奥奥特** 并单击 **创建** - OAuth的终点是 自动发现
5.  在 AssetLab 授权页面上粘贴您的 API 密钥(`al_live_...`(中文(简体) )

### 微软副驾驶(通过副驾驶工作室)

副驾驶聊天没有“ 添加服务器” 字段, 所以一个人会建立代理并发布一次 ;然后工作人员在普通微软365副驾驶内部使用该代理.

1.  在其中创建 API 密钥 **资产列表 设置 API 密钥**
2.  单位 [副驾驶工作室](https://copilotstudio.microsoft.com/),打开具有基因特性的剂 乐团和选择 **工具 • 添加工具 + 新工具 + 模式背景协议**
3.  服务器 URL: `https://mcp.assetlab.ca/mcp?profile=core`
4.  认证 **API 密钥**类型 **页眉**,页眉名称 `Authorization`; 连接 值为 `Bearer al_live_...`
5.  将代理发布到 **微软365 副驾驶** {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}有一位管理员批准 {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}你应该知道

使用 `?profile=core` 地址在这里。 副驾驶工作室给128个工具的代理机盖上帽子 建议25-30;此服务器发布 480+ `core` 配置答案为 28 包括场地、建筑物、资产、工作订单、工作要求、首相时间表和供应商. Claude和ChatGPT没有这样的盖子,应该使用普通的URL.

### Claude桌面/ Claude 代码( 本地、 stdio)

这个软件包作为本地的 MCP 服务器运行于 stdio 之上 - 网络上没有任何信息曝光.

```json
{
  "mcpServers": {
    "assetlab": {
      "command": "npx",
      "args": ["-y", "@assetlab/mcp-server"],
      "env": {
        "ASSETLAB_API_KEY": "al_live_...",
        "ASSETLAB_API_URL": "https://<your-project>.supabase.co/functions/v1/api-gateway"
      }
    }
  }
}
```

您的资产实验室管理员可以为您的组织提供 API URL .

* * *

## 你能问什么?

| 你说 | 没错 |
| --- | --- |
| _"给我看所有逾期的工作订单"_ | 列出它们, 排序, 链接到资产列表 |
| _"为3号楼破损的泵房设计工作订单"_ | 查查大楼和资产,然后创造 |
| _"哪个项目有风险或延迟?"_ | 扫描项目状况和风险 |
| _"资产X的总成本历史是多少"_ | 汇总每个成本记录 |
| _水分超过500毫米,条件差_ | 按直径和条件过滤基础设施特征 |
| _"在人行道策略上加上快克密封事件 每平方公尺4美元"_ | 保持你的生命周期策略 |
| _"这个月应该有什么样的首相时间表?"_ | 检查每个时间表的下一个到期日 |
| _"更新WO-1234上的优先级至紧急"_ | 编辑记录( 带有您的写入范围) |

* * *

## 2.7里有什么新鲜事

**微软Copilot的全能工具简介.** 添加中 `?profile=core` 给东道主的 服务器 URL 发布了28个工具,而不是 480+, 这使得服务器可用于 限制一个代理主机可容纳多少工具的客户端 - Microsoft Copilot Studio允许128 建议25-30 一个未识别的描述文件名称被拒绝而非静静地服务 完整的目录。 Claude和ChatGPT不受影响,保留完整的工具集.

* * *

## 2.5里有什么新鲜事

**设施生命周期战略.** 生命周期战略工具现在涵盖建筑物和 设备,而不仅仅是线性基础设施。 5个新工具 `asset_lifecycle_events` 范围 读取并保持基于条件的干预 ("条件70-85的屋顶再加五年"). 某类或某类资产所附带的事件 资产类型组而不是单个资产,所以一个事件维持一个完整的类别 设备.

**事件说他们成为了什么样的工作.** 双方的生命周期事件现在都有 `work_generation` 设定 -- -- 仅计划、工作秩序或项目 -- -- 因此是适当的干预 记录它应该变成什么。 任何内容都无法按期创建;发言 清单留在作出决定的地方.

* * *

## 工具目录

工具遵循一个命名模式: `list_*` 编号 : `get_*` 读取, `create_*` 编号 : `update_*` 编号 : `delete_*` 写作. **读取** 以下为清单/清单; **写入** 表示 创建/更新/删除( 每项资源的可用性略有不同 - 工具描述) 这是权威.

**资产和维护记录** (17个资源)

| 资源 | 读取 | 写入 |
| --- | --- | :-: |
| 资产 | ✓ | ✓ |
| 资产评论 成本 文档 部分 | ✓ | ✓ |
| 资产安放(底板平针) | ✓ | ✓ |
| 资产更换计划 | ✓ | ✓ |
| 资产状况评估 | ✓ | ✓ |
| 资产生命周期活动(战略) | ✓ | ✓ |
| 资产风险历史 | ✓ | \- 说吧 |
| 资产状况 类型 类型 | ✓ | ✓ |
| 附录(+) `upload_file`, (中文(简体) ), `create_upload_url`(中文(简体) ) | ✓ | ✓ |
| 制造商 | ✓ | ✓ |
| · 部分类别 | ✓ | ✓ |

**工作管理** (7个资源)

| 资源 | 读取 | 写入 |
| --- | --- | :-: |
| 工作订单 | ✓ | ✓ |
| 工作订单注释 附表 | ✓ | ✓ |
| 工作要求 | ✓ | ✓ |
| 工作类别 | ✓ | ✓ |
| 首相时间表 | ✓ | ✓ |
| PM 模板 | ✓ | ✓ |

**场地、建筑物和系统** (11个资源)

| 资源 | 读取 | 写入 |
| --- | --- | :-: |
| 站点 | ✓ | ✓ |
| 站点 FCI 历史 | ✓ | \- 说吧 |
| 建筑物类型 | ✓ | ✓ |
| 地点 地点类型 | ✓ | ✓ |
| 系统类 系统组 | ✓ | ✓ |
| 平面图 平面图区域 | ✓ | ✓ |

**基础设施(线性资产)** (11个资源)

| 资源 | 读取 | 写入 |
| --- | --- | :-: |
| 特征类 | ✓ | ✓ |
| 网络 | ✓ | ✓ |
| 特征( 分集和节点, GeoJSON 几何) | ✓ | ✓ |
| 特征检查 | ✓ | ✓ |
| 生命周期活动(战略) | ✓ | ✓ |
| 区 | ✓ | ✓ |
| 专题评论 成本 文档 部分 | ✓ | ✓ |
| 特征风险历史 | ✓ | \- 说吧 |

**项目和资本规划** (20+资源)

| 资源 | 读取 | 写入 |
| --- | --- | :-: |
| 项目 | ✓ | ✓ |
| 任务 任务依赖 里程碑 | ✓ | ✓ |
| · 阶段类别 | ✓ | ✓ |
| 预算项目 时间条目 费用简介 | ✓ | ✓ |
| 评论 增补 风险 小组成员 | ✓ | ✓ |
| · 文件文件夹模板 | ✓ | ✓ |
| 项目连接(资产、建筑物、场地、地点、系统、基础设施) | ✓ | ✓ |
| 服务领域(+站点和系统级链接) | ✓ | ✓ |

**财务和供应商** (10个资源)

| 资源 | 读取 | 写入 |
| --- | --- | :-: |
| 预算 | ✓ | ✓ |
| 支出 发票 定购单 | ✓ | ✓ |
| 变更单 | ✓ | ✓ |
| 费用类别 | ✓ | ✓ |
| 合同地点 合同文件 | ✓ | ✓ |
| 供应商的现场分配 | ✓ | ✓ |

**遵守、形式和服务水平** (15个资源)

| 资源 | 读取 | 写入 |
| --- | --- | :-: |
| 合规项目 记录 | ✓ | ✓ |
| 格式模板 · 模板项目 | ✓ | ✓ |
| 表格答复 | ✓ | ✓ |
| 格式回复 | ✓ | \- 说吧 |
| 计量 | ✓ | ✓ |
| 拟议目标 | ✓ | ✓ |
| LOS 目标历史 | ✓ | \- 说吧 |
| • 基础设施目标 | ✓ | ✓ |
| 关键修饰剂 | ✓ | ✓ |
| 后果 | ✓ | ✓ |
| LOS 状态快照 | ✓ | \- 说吧 |

**管理和分析** (6个资源)

| 资源 | 读取 | 写入 |
| --- | --- | :-: |
| 用户 | ✓ | \- 说吧 |
| 自定义 ^ 值 | ✓ | ✓ |
| ·快照 | ✓ | \- 说吧 |
| 散装业务(`bulk_create`, (中文(简体) ), `bulk_update`(中文(简体) ) | \- 说吧 | ✓ |

* * *

## 范围

API 密钥使用瞄准镜来精确控制您的助手可以触摸到什么. 配置 每个资源在 **设置 ~ API 密钥** - 范围按下列方式分类: 类别(业务、设施、项目、财务、基础设施等) 批量切换控制.

| 范围模式 | 访问 |
| --- | --- |
| `resource:read` | 列出并获得记录(例如:. `assets:read`, (中文(简体) ), `work_orders:read`(中文(简体) ) |
| `resource:write` | 创建、更新和删除记录(例如:. `assets:write`(中文(简体) ) |
| `*:*` | 充分获得所有资源 |

* * *

## 警卫

-   **OAuth 2.0 + PKCE** 结束 `mcp.assetlab.ca`; 您的 API 密钥已加密到 中转且从未被 MCP 服务器存储
-   **租户** - 每一个密钥都只标注在您的组织上, 和服务器上 无视任何试图解决另一个租户的尝试
-   **审计** - 所有数据访问都登录在资产实验室的审计日志中
-   **可逆转** - 随时撤销密钥 **设置 ~ API 密钥**它会立刻死亡
-   **默认只读** - 写作操作需要明确的写作范围

* * *

## 支助

问题还是问题? 电子邮件 [支持@assetlab.ca](mailto:support@assetlab.ca)。 。 。 .

文档 : [页:1](https://assetlab.ca/) → **文件 ∗ AI & MCP**

## 常见问题

### @assetlab/mcp-server 是什么？

AssetLab 的 MCP 服务器 — 将 Claude 或 ChatGPT 连接到您的资产管理数据

### 如何安装 @assetlab/mcp-server？

在项目目录运行 npm install @assetlab/mcp-server，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 assetlab-mcp，可以用 npx assetlab-mcp 直接运行。

### @assetlab/mcp-server 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @assetlab/mcp-server 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @assetlab/mcp-server 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @assetlab/mcp-server 可以商用吗？

@assetlab/mcp-server 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @assetlab/mcp-server 的下载量有多少？

根据 npm 官方下载统计，@assetlab/mcp-server 在 2026/10/07 – 2026/11/05 这 30 天内被下载 2,783 次，日均约 93 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @assetlab/mcp-server 还在维护吗？

最新版本 3\.3\.0 发布于 2026/10/22（16 天前）；至今共发布 77 个版本，其中过去 12 个月发布了 77 个；首次发布于 2026/03/17。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。