Pabal MCP

🚀 App Store Connect與Play Console API的MCP服務器

本項目將最新的ASO工作流以MCP工具的形式呈現。你可以將其作為標準輸入輸出的MCP服務器（如Claude Code、Cursor、MCP Inspector等）運行，從而無需離開AI客戶端即可管理應用商店的元數據、發佈版本以及進行同步操作。

⚠️ 重要提示

該服務完全在本地運行，因此你的憑證和緩存的ASO數據不會離開本地環境（商店API調用直接從你的設備發起）。

🚀 快速開始

如果你需要管理應用在App Store Connect和Google Play Console上的相關信息，本MCP服務器將為你提供便捷的解決方案。通過它，你可以在AI客戶端內完成各種操作，無需手動在應用商店後臺進行繁瑣的點擊。

✨ 主要特性

❌ 不使用pabal - mcp的情況

• 每次更新都需要手動在App Store Connect和Google Play Console中進行操作。
• 在不同地區和版本說明之間複製粘貼時容易出錯。
• 每個客戶或項目都需要重複相同的設置步驟。

✅ 使用pabal - mcp的優勢

• 一個MCP服務器即可處理兩個應用商店的ASO數據拉取和推送。
• 可以在AI客戶端中進行一致的版本說明更新和版本檢查。
• 基於本地緩存和配置，擁有可複用、可腳本化的工作流。

📦 安裝指南

要求

• Node.js >= 18
• MCP客戶端：Cursor、Claude Code、VS Code、Windsurf等。

💡 使用建議

如果你經常進行ASO或應用商店相關任務，可以添加一個客戶端規則，如“始終使用pabal - mcp”，這樣MCP服務器將自動調用，無需每次都手動輸入。

全局安裝（推薦）

npm install -g pabal-mcp
# 或者
yarn global add pabal-mcp

建議先進行全局安裝，以實現最快啟動並避免npm下載問題（如代理、防火牆或離線情況）。你仍然可以使用npx -y pabal - mcp，但全局安裝是更好的選擇。全局安裝後，將MCP配置設置為command: "pabal - mcp"（無需使用npx）。

{
  "mcpServers": {
    "pabal-mcp": {
      "command": "npx",
      "args": ["-y", "pabal-mcp"]
    }
  }
}

"mcp": {
  "servers": {
    "pabal-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "pabal-mcp"]
    }
  }
}

{
  "mcpServers": {
    "pabal-mcp": {
      "command": "npx",
      "args": ["-y", "pabal-mcp"]
    }
  }
}

{
  "mcpServers": {
    "pabal-mcp": {
      "command": "pabal-mcp"
    }
  }
}

{
  "mcpServers": {
    "pabal-mcp": {
      "command": "npx",
      "args": ["-y", "pabal-mcp"]
    }
  }
}

🔐 配置憑證

1. 創建配置目錄並設置權限：

mkdir -p ~/.config/pabal-mcp
chmod 700 ~/.config/pabal-mcp
open ~/.config/pabal-mcp

2. 創建配置文件（預填充佔位符）：

cat <<'EOF' > ~/.config/pabal-mcp/config.json
{
  "dataDir": "/ABSOLUTE/PATH/TO/pabal-web",
  "appStore": {
    "issuerId": "xxxx",
    "keyId": "xxxx",
    "privateKeyPath": "./app-store-key.p8"
  },
  "googlePlay": {
    "serviceAccountKeyPath": "./google-play-service-account.json"
  }
}
EOF

在獲取App Store Connect密鑰後，下一步將替換issuerId和keyId佔位符。dataDir是從每個應用商店拉取的原始數據存儲的絕對路徑（例如，/ABSOLUTE/PATH/TO/pabal - web）。

3. 將憑證添加到~/.config/pabal - mcp/：

   App Store Connect API密鑰：

   • App Store Connect > 用戶與訪問 > 密鑰 → “生成API密鑰”。使用管理員/應用管理器權限，下載.p8文件（僅可下載一次），並將其保存為~/.config/pabal - mcp/app - store - key.p8。
   • 從密鑰詳細信息中複製發行商ID和密鑰ID，然後使用這些值更新~/.config/pabal - mcp/config.json中的issuerId和keyId。

   Google Play服務賬戶JSON文件：

   • Google Cloud管理服務賬戶 → 創建一個服務賬戶（為清晰起見，將其命名為pabal） → 創建密鑰 → JSON。
   • 將下載的JSON文件保存為~/.config/pabal - mcp/google - play - service - account.json。
   • 授予該服務賬戶電子郵件訪問Play Console的權限：轉到[用戶和權限](https://play.google.com/console/u/0/developers/users - and - permissions) → 邀請新用戶 → 輸入服務賬戶電子郵件 → 選擇ASO應用 → 啟用以下權限：
     • 查看應用信息並下載批量報告（只讀）
     • 創建、編輯和刪除應用草稿
     • 發佈到生產環境
     • 管理設備排除列表
     • 使用Play應用簽名
     • 管理應用商店展示

   配置文件結構（更新ID後）：

   {
     "dataDir": "/ABSOLUTE/PATH/TO/pabal-web",
     "appStore": {
       "issuerId": "<your-issuer-id>",
       "keyId": "<your-key-id>",
       "privateKeyPath": "./app-store-key.p8"
     },
     "googlePlay": {
       "serviceAccountKeyPath": "./google-play-service-account.json"
     }
   }
   

4. 拉取應用商店數據 使用apps - init命令從應用商店API獲取並自動註冊現有應用。這將使用你應用商店中可用的應用填充~/.config/pabal - mcp/registered - apps.json文件。

5. 鎖定文件權限（配置文件夾中的所有文件）：

chmod 600 ~/.config/pabal-mcp/*

此操作適用於~/.config/pabal - mcp/下的每個文件；添加任何新的憑證文件後，請重新運行此命令。

🔧 技術細節

MCP工具

• 身份驗證
  • auth - check：檢查App Store Connect / Google Play的身份驗證。
• 應用管理
  • apps - init：從應用商店API獲取應用並自動註冊它們（Google Play需要packageName）。
  • apps - add：通過bundleId/packageName註冊單個應用。
  • apps - search：搜索已註冊的應用。
• ASO數據同步
  • aso - pull：將ASO數據獲取到.aso/本地緩存。
  • aso - push：將.aso/中的ASO數據推送到應用商店。
• 版本發佈管理
  • release - check - versions：顯示每個應用商店的最新版本。
  • release - create：創建新版本。
  • release - pull - notes：將版本說明拉取到.aso/緩存。
  • release - update - notes：更新版本說明/新增內容。

🏗️ 開發

從源代碼構建

git clone https://github.com/quartz-labs-dev/pabal-mcp.git
cd pabal-mcp
yarn install
yarn dev:mcp

測試

運行所有測試：npm test

📄 許可證

本項目採用MIT許可證。

🌐 Pabal Web

想同時管理ASO和SEO嗎？快來了解Pabal Web。

Pabal Web是一個基於Next.js的Web界面，為ASO、SEO、Google Search Console索引等的統一管理提供了完整的解決方案。

👉 訪問Pabal Web