mcp-npm-publish

MCP 服务器，用于 npm 登录/发布/查看包操作。TypeScript 编写，通过 npx 直接运行。

• License: MIT
• npm: mcp-npm-publish
• npx: npx -y mcp-npm-publish

配置

在 MCP 客户端中添加：

{
  "mcpServers": {
    "mcp-npm-publish": {
      "command": "npx",
      "args": ["-y", "mcp-npm-publish"],
      "env": {
        "NPM_TOKEN": "${NPM_TOKEN}"
      }
    }
  }
}

本地开发

# 安装依赖
yarn

# 编译 TypeScript
npm run build

# 启动 MCP 服务器
node ./dist/index.js

环境变量

变量	必填	说明
NPM_TOKEN	是	npm 访问令牌（发布操作必需）

该 MCP 仅用于官方 npm registry，所有命令强制使用 https://registry.npmjs.org，不受本地 npmrc 配置影响。

工具

工具	功能
npm-token-status	检查 NPM_TOKEN 状态和登录状态，用于发布/登录前的状态确认
npm-login	登录指引：获取和设置 NPM_TOKEN，首次使用 npm 时由此开始
npm-publish	发布包到 npm registry。自动预检 + 版本确认 + 错误诊断。发布前必须确认版本号
npm-view	查看 registry 上的包信息（含个人包），用于发布后验证
npm-logout	退出登录：指引移除 NPM_TOKEN 和撤销 token
v	版本信息。任何情况下都不调用此工具

发布流程

npm-publish 工具包含强制版本确认流程，不可跳过：

第 1 步：不带参数调用，获取版本建议

// 调用 npm-publish（不传任何参数）
// 工具返回：
{
  "建议新版本号": "1.0.8",
  "提示": "请确认版本号，然后传入 version 和 confirmed=true"
}

第 2 步：用户确认版本号

工具会建议下一个版本（按最小递增规则：1.0.0 → 1.0.1，1.0.9 → 1.1.0，1.9.9 → 2.0.0）。必须获得用户明确确认。

第 3 步：传入确认参数执行发布

// 调用 npm-publish
{
  "version": "1.0.8",
  "confirmed": true
}

⚠️ confirmed 参数为强制安全开关。任何直接传入 version 但不带 confirmed=true 的调用都会被工具拒绝。AI 不得自行将 confirmed 设为 true，必须等待用户明确回答"是"。

使用

# 设置 token
export NPM_TOKEN="npm_xxxxxx..."

# 检查登录状态
# 调用 npm-token-status

# 登录指引
# 调用 npm-login

# 发布包（必须经过版本确认）
# 第1步：调用 npm-publish
# 第2步：用户确认版本号
# 第3步：调用 npm-publish version="x.y.z" confirmed=true

# 查看已发布的包
# 调用 npm-view package="my-package"

# 退出登录
# 调用 npm-logout