PGYER

io.github.PGYER由 GitHub 帳號 PGYER 發布v2.0.0更新於 Oct 29, 2026

Upload Android, iOS and HarmonyOS apps to PGYER and manage their apps and versions.

已驗證STDIO僅桌面檔案與儲存開發者工具

概覽

AI 產生的概覽

把 Android、iOS 與鴻蒙測試包上傳到蒲公英（PGYER），並讓助理列出應用程式與版本、取得下載頁與 QR code、調整應用程式設定。

可以做什麼
  • 上傳本機的 .apk、.ipa 或 .hap 安裝包，回傳下載頁網址與 QR code 網址
  • 依 buildKey 查詢上傳處理狀態，可設定等待時間
  • 分頁列出帳號下的應用程式與歷史版本，依 appKey 或短網址查看應用程式詳情
  • 設定或取消某個版本的「最新版本」標記
  • 修改下載頁與安裝設定，支援 dryRun 預覽
適用情境
適合在本機建置行動或鴻蒙應用程式後，讓助理把測試包發佈到蒲公英並把下載連結或 QR code 交給測試人員，或在不開網頁主控台的情況下查詢既有應用程式與版本。
執行需求
透過 npx 以 stdio 在本機執行，需要 Node.js 20.19 或更新版本。需要蒲公英 API Key，從環境變數 PGYER_API_KEY 讀取，或使用蒲公英命令列工具登入後存在本機的憑證。需要能連線到蒲公英的網路。
安裝前請注意
API Key 屬於憑證，盡量避免寫進共用的設定檔。上傳會發佈建置並產生公開下載頁，分享前請確認內容。set_latest_version 與 update_app_settings 會變更既有應用程式狀態，伺服器本身也建議先取得使用者同意。沒有刪除工具，也不會回傳安裝密碼。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 PGYER，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

PGYER MCP Server

English | 中文

蒲公英（PGYER）的 MCP（Model Context Protocol）服务器。在 Claude、Cursor、VS Code、Codex 等 AI 客户端里直接上传 Android（.apk）、iOS（.ipa）和鸿蒙（.hap）安装包，查询应用与历史版本，修改应用设置。

[Claude Screenshot]

从 2.0 开始，本包只是一个启动器：服务器本身由蒲公英命令行工具 @pgyer/cli（pgyer mcp）提供，两者的工具和行为完全相同。原有的 npx -y pgyer-mcp-server 配置无需修改。

准备

服务器优先读取环境变量 PGYER_API_KEY；没有设置时，使用 pgyer auth login 保存在本机的凭证。

配置

Claude Code

bash
claude mcp add pgyer --env PGYER_API_KEY=<your_pgyer_api_key> -- npx -y pgyer-mcp-server

Claude Desktop

编辑 claude_desktop_config.json（设置 → 开发者 → 编辑配置）：

json
{  "mcpServers": {    "pgyer": {      "command": "npx",      "args": ["-y", "pgyer-mcp-server"],      "env": { "PGYER_API_KEY": "<your_pgyer_api_key>" }    }  }}

Cursor

在 ~/.cursor/mcp.json（全局）或项目内的 .cursor/mcp.json 中添加：

json
{  "mcpServers": {    "pgyer": {      "command": "npx",      "args": ["-y", "pgyer-mcp-server"],      "env": { "PGYER_API_KEY": "<your_pgyer_api_key>" }    }  }}

VS Code

一键添加：

bash
code --add-mcp '{"name":"pgyer","command":"npx","args":["-y","pgyer-mcp-server"],"env":{"PGYER_API_KEY":"<your_pgyer_api_key>"}}'

或在项目的 .vscode/mcp.json 中添加（启动时提示输入 API Key，不会写进文件）：

json
{  "inputs": [    { "type": "promptString", "id": "pgyer-api-key", "description": "PGYER API Key", "password": true }  ],  "servers": {    "pgyer": {      "type": "stdio",      "command": "npx",      "args": ["-y", "pgyer-mcp-server"],      "env": { "PGYER_API_KEY": "${input:pgyer-api-key}" }    }  }}

Codex

bash
codex mcp add pgyer --env PGYER_API_KEY=<your_pgyer_api_key> -- npx -y pgyer-mcp-server

或编辑 ~/.codex/config.toml。Codex 默认的工具超时是 60 秒，上传较大的安装包时请调大：

toml
[mcp_servers.pgyer]command = "npx"args = ["-y", "pgyer-mcp-server"]env = { PGYER_API_KEY = "<your_pgyer_api_key>" }tool_timeout_sec = 900

已全局安装 @pgyer/cli 并执行过 pgyer auth login 时，也可以把命令换成 pgyer mcp，并省略 PGYER_API_KEY。

工具

工具作用只读覆盖已有状态
upload_app上传 .apk/.ipa/.hap 并等待蒲公英处理完成，返回下载页地址、二维码、版本号等；支持安装方式、安装密码、更新说明、应用介绍、安装有效期、渠道短链接、海外/国内上传和处理超时；客户端提供 progressToken 时发送上传和处理进度否否
get_upload_status按 buildKey 查询上传的处理结果（upload_app 处理超时后使用），可设置等待时间是否
list_apps分页列出账号下的应用及其最新版本是否
get_app按 appKey 或短链接（也可以是完整的下载页地址）查询应用详情，可指定历史版本是否
list_versions按 appKey 或短链接分页列出历史版本是否
set_latest_version设置或取消某个版本的「最新版本」标记否是
update_app_settings修改短链接、安装方式与密码、安装有效期、下载页语言、版本号来源、自动同步和版权显示；未指定的设置保持不变，支持 dryRun否是
  • 上传只发送你指定的设置，未指定的设置保持应用当前的值
  • 不提供删除应用或版本的工具，也不会返回安装密码
  • 主域名 www.pgyer.com 无法访问时，自动改用 www.xcxwo.com、www.pgyerapp.com
  • API Key 只在 HTTPS 请求正文中发送，不会出现在 URL 里

从 1.x 升级

2.0 的工具名称改为 snake_case 并增加了新工具。如果你的提示词或客户端的工具白名单写了旧名称，请相应修改：

1.x2.0
upload-appupload_app（新增全部上传设置与进度通知）
list-my-appslist_apps
get-app-info-by-shortcutget_app（参数 shortcut）

工具的返回结果也改为整理后的结构化数据，不再原样返回 API 响应。1.x 把 API Key 放在查询上传结果的 URL 中，2.0 已修复。

Docker

bash
docker build -t pgyer-mcp-server .docker run -i --rm -e PGYER_API_KEY=<your_pgyer_api_key> pgyer-mcp-server

开发与发布

服务器代码在 PGYER/pgyer-cli 的 src/mcp/ 中，问题与改进请提交到该仓库。本仓库只包含启动器、MCP Registry 元数据（server.json）和文档。发布步骤见 RELEASING.md。

许可证

MIT

來源：README.md，提交 7ac4f8a

工具

7

upload_app

Upload app to PGYER

Upload an Android (.apk), iOS (.ipa) or HarmonyOS (.hap) package from this machine to PGYER and wait until PGYER has processed it. Returns the published build with its download page URL (share it with testers) and QR code image URL. PGYER matches the package to an existing app by its package identifier, or creates the app on the first upload. Only the settings you pass are changed; the app keeps its current values for the rest. Large files can take several minutes. If PGYER is still processing when processingTimeoutSeconds ends, the result has status "processing" and a buildKey: call get_upload_status with it later instead of uploading again.

輸入參數overseafilePath必填passworddescriptioninstallTypeinstallEndDatechannelShortcutinstallStartDateupdateDescriptionprocessingTimeoutSeconds

get_upload_status

Get upload status

Check whether PGYER has finished processing an upload, by the buildKey that upload_app returned with status "processing". Returns the published build with its download page URL once it is ready. Set waitSeconds to keep checking for up to that long.

輸入參數buildKey必填waitSeconds

list_apps

List apps

List the apps in the PGYER account, 20 per page, with each app's latest version and download page. Use page to see more; pageCount tells how many pages there are.

輸入參數page

get_app

Get app details

Get an app's details by appKey or by shortcut (or a full https://www.pgyer.com/<shortcut> URL): latest version, download page, QR code, install type, install period and download page settings. Pass buildKey together with appKey to get one specific historical build. The install password is never returned.

輸入參數appKeybuildKeyshortcut

list_versions

List app versions

List the uploaded versions (builds) of an app, newest first, by appKey or shortcut. isLatest shows which build carries PGYER's latest-version mark. Use page to see older builds.

輸入參數pageappKeyshortcut

set_latest_version

Set latest version

Mark a build as the latest version of its app (latest: true, the default), or remove the latest-version mark from it (latest: false). Get build keys from list_versions. Ask the user before changing which build is marked latest.

輸入參數latestbuildKey必填

update_app_settings

Update app settings

Change an app's download page and installation settings. Only the settings you pass change; the rest keep their current values. Use dryRun to see which settings would change without saving.

輸入參數appKey必填dryRunautoSynclanguagepasswordshortcutinstallTypeversionSourceinstallEndDateinstallStartDateshowPgyerCopyrightremoveInstallPeriod

版本歷史

1
  1. v2.0.0最新Oct 21, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分
  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分