PGYER

PGYER MCP Server

English | 中文

蒲公英（PGYER）的 MCP（Model Context Protocol）伺服器。在 Claude、Cursor、VS Code、Codex 等 AI 用戶端裡直接上傳 Android（.apk）、iOS（.ipa）和鴻蒙（.hap）安裝包，查詢應用與歷史版本，修改應用設定。

從 2.0 開始，本套件只是一個啟動器：伺服器本身由蒲公英命令列工具 @pgyer/cli（pgyer mcp）提供，兩者的工具和行為完全相同。原有的 npx -y pgyer-mcp-server 設定無需修改。

準備

• Node.js 20.19 或更高版本
• 蒲公英 API Key：在 API 資訊頁面 取得

伺服器優先讀取環境變數 PGYER_API_KEY；沒有設定時，使用 pgyer auth login 儲存在本機的憑證。

設定

Claude Code

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

Claude Desktop

編輯 claude_desktop_config.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 中新增：

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

VS Code

一鍵新增：

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，不會寫進檔案）：

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

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

或編輯 ~/.codex/config.toml。Codex 預設的工具逾時是 60 秒，上傳較大的安裝包時請調大：

[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 並等待蒲公英處理完成，回傳下載頁位址、QR Code、版本號等；支援安裝方式、安裝密碼、更新說明、應用介紹、安裝有效期、渠道短連結、海外/國內上傳和處理逾時；用戶端提供 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.x	2.0
upload-app	upload_app（新增全部上傳設定與進度通知）
list-my-apps	list_apps
get-app-info-by-shortcut	get_app（參數 shortcut）

工具的回傳結果也改為整理後的結構化資料，不再原樣回傳 API 回應。1.x 把 API Key 放在查詢上傳結果的 URL 中，2.0 已修復。

Docker

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