# @burdenoff/mcp-libs 中文文档

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

版本：2026\.1108\.1
npm 元数据更新时间：2026-11-08T04:24:30.155Z
中文译文更新时间：2026-11-08T20:15:47.247Z
软件包许可：UNLICENSED

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

原始 npm 页面：https://www.npmjs.com/package/%40burdenoff/mcp-libs
原文对照：https://npmcn.com/package/%40burdenoff/mcp-libs/?lang=original
项目主页：https://github.com/Algoshred/mcp-libs#readme
源码仓库：https://github.com/Algoshred/mcp-libs

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

- 包体积（解压后）：26.3 MB，888 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=24\.11\.0
- 运行依赖：1 个
- peer 依赖：zod ^3\.25\.0 \|\| ^4\.6\.6，graphql ^16\.0\.0，graphql-request ^7\.0\.0，@modelcontextprotocol/sdk 1\.32\.1
- 首次发布：2026-05-11T08:42:13.279Z
- 最新版本发布：2026-11-08T04:24:30.014Z
- 近 30 天下载量：6700（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：87（近 12 个月 87 个）

## 中文简介

模块化的MCP SDK在所有Burdenoff产品MCP(活控制器,botlit,流体网格,大锥管,健康碗,工作空间)中共享. 每个模块都输出出McpModule合同;产品MCP会变成薄壳来选择要挂起的模块.

## 安装

```sh
npm install @burdenoff/mcp-libs
```

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

## README

# @ buffoff/ mcp- libs

模块MCP SDK在所有Burdenoff产品MCP中共享.

每一单元 `src/modules/<name>/` 导出a `McpModule`. 产品 MCP 变成薄壳(~125行),取出要挂载的模块,构建一个 `McpContext`选择运输工具 运送二进制.

## 现况 - `1.0.0`

23个模块覆盖 `vibecontrols-app`'微前端(~317个工具 / 7个资源 / 7个提示) :

| 域名 | 模块 |
| --- | --- |
| 身份 | `auth` (完整的地表,包括mfa、api-keys、sso、代表团), `rbac`, (中文(简体) ), `organizations`, (中文(简体) ), `tours` |
| 工作空间原始人 | `workspaces`, (中文(简体) ), `groups`, (中文(简体) ), `tags`, (中文(简体) ), `files`, (中文(简体) ), `conversations`, (中文(简体) ), `security` |
| 业务 | `integrations`, (中文(简体) ), `channels`, (中文(简体) ), `scheduler`, (中文(简体) ), `export`, (中文(简体) ), `notifications`, (中文(简体) ), `support`, (中文(简体) ), `products`, (中文(简体) ), `devportal` |
| 商业 | `billing`, (中文(简体) ), `store` |
| 产品表面 | `vibecontrols` (富;16个分实体), `sandbox`, (中文(简体) ), `health` |

在6个产品MCP中上载: `vibecontrols`, (中文(简体) ), `botlit`, (中文(简体) ), `fluidgrids`, (中文(简体) ), `bigconsole`, (中文(简体) ), `healthybowl`, (中文(简体) ), `workspaces` – 每一个都使用相同的23个模块的目录,其中产品前缀工具名通过 `mcpToolName(productName, …)`。 。 。 .

在平台目录之外,每个产品外壳都有一个域模块,承载该产品自己的表面 (今天32个,例如:. `vibecontrols`, (中文(简体) ), `healthybowl`, (中文(简体) ), `bigconsole` 后者是16个工具最少的特权 控制台授权集:数据汇、仪表板/页、解析器、部件、进出口、生成-即时).

## 安装

```bash
bun add @burdenoff/mcp-libs @modelcontextprotocol/sdk graphql graphql-request zod
```

HTTP 运输:

```bash
bun add express cors
```

## 快速启动( MCP shell 产品)

```ts
#!/usr/bin/env node
import { buildContext, createMcpServer } from '@burdenoff/mcp-libs/core';
import { startStdioServer, startHttpServer } from '@burdenoff/mcp-libs/transports';
import authModule from '@burdenoff/mcp-libs/modules/auth';
import vibecontrolsModule from '@burdenoff/mcp-libs/modules/vibecontrols';
// ... import the rest of the 23 modules as needed
import pkg from '../package.json' with { type: 'json' };

const ctx = buildContext({
  productName: 'vibecontrols',
  productVersion: pkg.version,
  serverName: 'vibecontrols-mcp',
  serverVersion: pkg.version,
  defaults: {
    configDirName: 'vibecontrols-mcp',
    oidcClientId: 'burdenoff_mcp_vibecontrols',
    workspaceEndpointDefault: 'http://localhost:4003/workspaces/graphql',
    globalEndpointDefault: 'http://localhost:4000/global/graphql',
    httpPortDefault: 3000,
  },
});

const server = createMcpServer(ctx, [authModule, vibecontrolsModule], {
  name: 'vibecontrols-mcp',
  version: pkg.version,
});

await startStdioServer(server, ctx);
```

## 仓库布局

-   `src/core/` —— 说 `McpModule`, (中文(简体) ), `McpContext`,错误类, gql 客户端, 认证, 配置, 输出帮助 .
-   `src/transports/` ——stdio + HTTP 运输工厂(表示动态进口).
-   `src/modules/<name>/` – 每个模块一个文件夹: `index.ts` (McpModule导出), `tools.ts`, (中文(简体) ), `resources.ts` (可选), `prompts.ts` (可选), `operations.ts`。 。 。 .

见 [克劳德·姆德](https://npmcn.com/package/%40burdenoff/mcp-libs/CLAUDE.md) 用于完整的建筑,硬规则,和添加-a-模块导.

## 许可证

UNLICENSED——负担咨询服务有限公司.

## FluidGrids 代码第一和持久工具

FluidGrids模块包括了SDK的代码第一和持久运行操作: `runs_by_workflow_id`, (中文(简体) ), `runs_count`, (中文(简体) ), `runs_describe`, (中文(简体) ), `runs_determinism`, (中文(简体) ), `runs_history`, (中文(简体) ), `runs_pending`, (中文(简体) ), `runs_signal`, (中文(简体) ), `runs_stack_trace`, (中文(简体) ), `runs_terminate`, (中文(简体) ), `workflows_create_version`, (中文(简体) ), `workflows_export`, (中文(简体) ), `workflows_import`, (中文(简体) ), `workflows_import_template`, (中文(简体) ), `workflows_interface`, (中文(简体) ), `workflows_start`,以及 `workflows_validate`。工具名称接收主机产品 前缀,例如 `fluidgrids_runs_history`。 。 。 .

运行接受的工具 `run` 支持运行的ID或 `{ workflowKey, workflowId, firstRunId? }` 目标。 历史界限为一页 (1至1 000个活动);通过 `nextAfter` 作为 `after` 继续。 文件已卸载 有效载荷 URL 在不下载的情况下返回 。 进口完全接受一个 联 合 国 `definitionJson` 或内置 JSON/ Type 脚本 `source` 文档。 基于 URL 源 进口没有暴露,因为后端储备并拒绝这种模式.

启动和信号可以执行外部动作,终止则停止运行 没有取消处理器。 他们明确广告 `destructiveHint: true`· ; 主机必须启用 `enforceDestructiveConfirmation` 要求 `confirm: true` 在操作员运行之前。 FluidGrids MCP 主机已启用此选项 . `TERMINATE_EXISTING` 还要求 `workflowId` 他们将被送到一个独立的地方 `startWorkflowTerminateExisting` 网关突变,执行删除 允许。 确认从未授予缺失的网关权限或功能 权利。 导入/版本创建草稿不激活或执行工作流程.

图书馆的MCP SDK对等是 `1.32.1`. 佐德 `^3.25.0` 保留用于 已有消费者, 而新主机应该安装补丁 Zod `^4.6.6`。 。 。 . 依赖性脆弱性检查和主机安装测试必须涵盖 实际解析的图表; 对等范围不是旧版本的安全检查.

## 常见问题

### @burdenoff/mcp-libs 是什么？

模块化的MCP SDK在所有Burdenoff产品MCP\(活控制器,botlit,流体网格,大锥管,健康碗,工作空间\)中共享\. 每个模块都输出出McpModule合同;产品MCP会变成薄壳来选择要挂起的模块\.

### 如何安装 @burdenoff/mcp-libs？

在项目目录运行 npm install @burdenoff/mcp-libs，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：zod（^3\.25\.0 \|\| ^4\.6\.6）、graphql（^16\.0\.0）、graphql-request（^7\.0\.0）、@modelcontextprotocol/sdk（1\.32\.1）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @burdenoff/mcp-libs 支持 TypeScript 吗？

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

### @burdenoff/mcp-libs 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

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

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

### @burdenoff/mcp-libs 可以商用吗？

@burdenoff/mcp-libs 使用 UNLICENSED 许可。作者声明为 UNLICENSED，即不授予公开使用许可（与公共领域的 Unlicense 不同）。使用前需获得作者授权。以上为概括，不构成法律意见，请以许可原文为准。

### @burdenoff/mcp-libs 的下载量有多少？

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

### @burdenoff/mcp-libs 还在维护吗？

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