PGYER

PGYER MCP Server

English | 中文

蒲公英（PGYER）の MCP（Model Context Protocol）サーバー。Claude、Cursor、VS Code、Codex などの AI クライアントから直接 Android（.apk）、iOS（.ipa）、HarmonyOS（.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 コード、バージョン番号などを返します。インストール方法、インストールパスワード、更新説明、アプリ紹介、インストール有効期限、チャネル短縮リンク、海外/国内アップロード、処理タイムアウトに対応。クライアントが 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