PGYER

PGYER MCP Server

English | 中文

Máy chủ MCP (Model Context Protocol) của Pgyer (PGYER). Tải trực tiếp các gói cài đặt Android (.apk), iOS (.ipa) và HarmonyOS (.hap) ngay trong các ứng dụng AI như Claude, Cursor, VS Code, Codex; tra cứu ứng dụng và các phiên bản trước đó, chỉnh sửa cài đặt ứng dụng.

Từ phiên bản 2.0, gói này chỉ là một trình khởi chạy: bản thân máy chủ được cung cấp bởi công cụ dòng lệnh Pgyer @pgyer/cli (pgyer mcp), các công cụ và hành vi của cả hai hoàn toàn giống nhau. Cấu hình npx -y pgyer-mcp-server hiện có không cần thay đổi.

Chuẩn bị

• Node.js 20.19 trở lên
• API Key của Pgyer: lấy tại trang thông tin API

Máy chủ ưu tiên đọc biến môi trường PGYER_API_KEY; khi chưa được thiết lập, sẽ dùng thông tin xác thực được lưu cục bộ bởi pgyer auth login.

Cấu hình

Claude Code

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

Claude Desktop

Chỉnh sửa claude_desktop_config.json (Cài đặt → Nhà phát triển → Chỉnh sửa cấu hình):

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

Cursor

Thêm vào ~/.cursor/mcp.json (toàn cục) hoặc .cursor/mcp.json trong dự án:

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

VS Code

Thêm bằng một cú nhấp:

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

Hoặc thêm vào .vscode/mcp.json của dự án (sẽ nhắc nhập API Key khi khởi động, không ghi vào tệp):

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

Hoặc chỉnh sửa ~/.codex/config.toml. Thời gian chờ công cụ mặc định của Codex là 60 giây, hãy tăng lên khi tải lên các gói cài đặt lớn:

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

Khi đã cài đặt @pgyer/cli toàn cục và đã thực thi pgyer auth login, bạn cũng có thể đổi lệnh thành pgyer mcp và bỏ qua PGYER_API_KEY.

Công cụ

Công cụ	Chức năng	Chỉ đọc	Ghi đè trạng thái hiện có
upload_app	Tải lên .apk/.ipa/.hap và chờ Pgyer xử lý xong, trả về địa chỉ trang tải xuống, mã QR, số phiên bản, v.v.; hỗ trợ phương thức cài đặt, mật khẩu cài đặt, ghi chú cập nhật, giới thiệu ứng dụng, thời hạn cài đặt, liên kết ngắn kênh, tải lên và xử lý ở nước ngoài/trong nước cùng thời gian chờ xử lý; gửi tiến trình tải lên và xử lý khi máy khách cung cấp progressToken	Không	Không
get_upload_status	Tra cứu kết quả xử lý của lần tải lên theo buildKey (dùng sau khi upload_app hết thời gian chờ xử lý), có thể đặt thời gian chờ	Có	Không
list_apps	Liệt kê theo trang các ứng dụng trong tài khoản và phiên bản mới nhất của chúng	Có	Không
get_app	Tra cứu chi tiết ứng dụng theo appKey hoặc liên kết ngắn (cũng có thể là địa chỉ trang tải xuống đầy đủ), có thể chỉ định phiên bản trước đó	Có	Không
list_versions	Liệt kê theo trang các phiên bản trước đó theo appKey hoặc liên kết ngắn	Có	Không
set_latest_version	Đặt hoặc hủy đánh dấu "phiên bản mới nhất" cho một phiên bản	Không	Có
update_app_settings	Sửa liên kết ngắn, phương thức và mật khẩu cài đặt, thời hạn cài đặt, ngôn ngữ trang tải xuống, nguồn số phiên bản, đồng bộ tự động và hiển thị bản quyền; các cài đặt không chỉ định giữ nguyên, hỗ trợ dryRun	Không	Có

• Khi tải lên chỉ gửi các cài đặt bạn chỉ định, các cài đặt không chỉ định giữ nguyên giá trị hiện tại của ứng dụng
• Không cung cấp công cụ xóa ứng dụng hoặc phiên bản, cũng không trả về mật khẩu cài đặt
• Khi không truy cập được tên miền chính www.pgyer.com, tự động chuyển sang www.xcxwo.com, www.pgyerapp.com
• API Key chỉ được gửi trong nội dung yêu cầu HTTPS, không xuất hiện trong URL

Nâng cấp từ 1.x

Tên công cụ của 2.0 đã đổi thành snake_case và bổ sung công cụ mới. Nếu câu lệnh gợi ý hoặc danh sách trắng công cụ của máy khách có ghi tên cũ, vui lòng sửa tương ứng:

1.x	2.0
upload-app	upload_app (bổ sung toàn bộ cài đặt tải lên và thông báo tiến trình)
list-my-apps	list_apps
get-app-info-by-shortcut	get_app (tham số shortcut)

Kết quả trả về của công cụ cũng đã đổi thành dữ liệu có cấu trúc đã được sắp xếp, không còn trả về nguyên bản phản hồi API. 1.x đặt API Key trong URL tra cứu kết quả tải lên, 2.0 đã khắc phục điều này.

Docker

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

Phát triển và phát hành

Mã máy chủ nằm trong src/mcp/ của PGYER/pgyer-cli, vui lòng gửi vấn đề và đề xuất cải tiến đến kho lưu trữ đó. Kho lưu trữ này chỉ chứa trình khởi chạy, siêu dữ liệu MCP Registry (server.json) và tài liệu. Các bước phát hành xem tại RELEASING.md.

Giấy phép

MIT