@ 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个工具最少的特权
控制台授权集:数据汇、仪表板/页、解析器、部件、进出口、生成-即时).
安装
bun add @burdenoff/mcp-libs @modelcontextprotocol/sdk graphql graphql-request zod
HTTP 运输:
bun add express cors
快速启动( MCP shell 产品)
#!/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。 。 。 .
见 克劳德·姆德 用于完整的建筑,硬规则,和添加-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。 。 。 .
依赖性脆弱性检查和主机安装测试必须涵盖
实际解析的图表; 对等范围不是旧版本的安全检查.