Skip to main content
Glama
LxyMp

mcp-npm-publish

by LxyMp

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}"
      }
    }
  }
}

Related MCP server: mcp-server-npm-plus

本地开发

# 安装依赖
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.01.0.11.0.91.1.01.9.92.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

Related MCP Connectors

Related MCP Servers