Plugin Light

Appearance

NPM 包发布工具 ​

npm-publish-mcp - NPM 包发布 MCP 工具

功能特性 ​

  • ✅ 触发发布流水线: 通过 MCP 工具触发 NPM 包发布流水线
  • ✅ 多版本类型支持: 支持 alpha、beta、patch 三种版本类型
  • ✅ 自动获取 Git 信息: 自动从当前目录获取仓库地址和分支名称
  • ✅ 外网发布支持: 支持发布到外网 NPM 仓库
  • ✅ Monorepo 支持: 支持指定子包名称进行发布

版本类型说明 ​

类型说明
alpha内测版本，用于内部测试
beta公测版本，用于公开测试
patch正式补丁版本，用于线上发布

安装 ​

bash
npm install npm-publish-mcp
# or
pnpm add npm-publish-mcp

MCP 工具调用规则 ​

NPM 发布工具 (npm-publish) ​

🔴【强制调用规则】：

  • 当用户需要发布 NPM 包时，AI 助手必须调用此 MCP 工具
  • 会自动从当前 Git 目录获取仓库地址和分支信息
  • 返回流水线触发结果

参数说明：

参数类型必填说明
versionTypestring✅版本类型：alpha、beta、patch
publishReasonstring条件必填发布原因，versionType 为 patch 时必填
publishExternalNPMboolean❌是否发布到外网 NPM，默认 false
publishPackagestring❌发布的子包名称（Monorepo 场景使用）
repostring❌Git 仓库地址，不传则自动获取
branchstring❌Git 分支名称，不传则自动获取

使用示例 ​

发布 alpha 版本 ​

json
{
  "versionType": "alpha"
}

发布 patch 版本到外网 ​

json
{
  "versionType": "patch",
  "publishReason": "修复登录页面样式问题",
  "publishExternalNPM": true
}

⚠️ 注意：发布 patch 正式版本时，必须填写 publishReason 说明发布原因

发布 Monorepo 中的指定子包 ​

json
{
  "versionType": "beta",
  "publishPackage": "my-package"
}

环境变量 ​

变量名说明
NPM_PUBLISH_API_URL发布接口地址

开发 ​

bash
# 构建
pnpm --filter "npm-publish-mcp" build

许可证 ​

MIT