starport-mcp

星港 Starport 发布平台的 MCP 服务。Agent 配置 API Key 后，可自动上传发布项目版本（七牛直传）。

安装

npm install -g starport-mcp
# 或用 npx 免安装：
npx -y starport-mcp

环境变量

| 变量 | 必填 | 说明 | |------|------|------| | STARPORT_BASE_URL | 是 | 星港 API 根地址，如 http://localhost:3000 或 https://your-host | | STARPORT_API_KEY | 是 | 在星港「个人资料 → API Key」创建，格式 sp_... |

获取 API Key

1. 登录星港管理台
2. 侧栏进入「API Key」页 → 创建 Key
3. 立即复制完整 Key（仅显示一次）

配置到 Cursor / Claude

{
  "mcpServers": {
    "starport": {
      "command": "npx",
      "args": ["-y", "starport-mcp"],
      "env": {
        "STARPORT_BASE_URL": "https://your-host",
        "STARPORT_API_KEY": "sp_..."
      }
    }
  }
}

工具

• list_projects：列出可见项目
• get_project：按 id 或 slug 查详情
• list_versions：列出项目版本
• request_node_upload_code：Node 项目下发钉钉验证码
• get_qiniu_upload_token：取七牛直传 token
• publish_version：发布已存在的本地 zip / html 文件
• publish_folder：自动压缩本地目录（过滤 node_modules 等）后发布
• activate_version：切换当前版本

发布流程

static 项目：publish_folder（传本地目录，自动打包过滤）或 publish_version（传现成 zip / html）。

node 项目：

1. request_node_upload_code 下发验证码
2. 从钉钉群读取 6 位验证码
3. publish_folder / publish_version 并传入 node_code

publish_folder 打包时自动过滤 node_modules、.git、.DS_Store、__MACOSX、__pycache__、.next 等（清单与服务端解压清理规则一致）。

前提

• 服务端须已配置 QINIU_*（七牛云 AK/SK/Bucket 等），否则发布失败
• Node 项目须已配置钉钉机器人（DINGTALK_WEBHOOK / DINGTALK_SECRET），否则无法下发验证码