Pabal MCP

🚀 App Store ConnectとPlay Console API用のMCPサーバー

このMCPサーバーは、最新のASOワークフローをMCPツールとして提供します。標準入出力MCPサーバー（Claude Code、Cursor、MCP Inspectorなど）として実行することで、AIクライアントから離れることなく、メタデータの管理、リリース、ストア同期を行うことができます。

⚠️ 重要提示

このサーバーはあなたのマシン上で100%ローカルに実行されるため、認証情報やキャッシュされたASOデータは決してあなたの環境を離れません（ストアAPI呼び出しは直接あなたのデバイスから行われます）。

🚀 クイックスタート

❌ pabal-mcpを使用しない場合

• 毎回の更新に際して、App Store ConnectとGoogle Play Consoleを手動でクリックする必要があります。
• ロケールやリリースノート間でのコピー＆ペーストエラーが発生しやすい。
• クライアントやプロジェクトごとに同じ設定を繰り返す必要があります。

✅ pabal-mcpを使用する場合

• 両方のストアのASOの取得と送信を処理する1つのMCPサーバーがあります。
• 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のアクセス権を付与します：ユーザーと権限にアクセス → 新しいユーザーを招待 → サービスアカウントのメールアドレスを入力 → ASOアプリを選択 → 以下の権限を有効にします。
    • アプリ情報の表示とバルクレポートのダウンロード（読み取り専用）
    • アプリのドラフトの作成、編集、削除
    • 本番環境へのリリース
    • デバイス除外リストの管理
    • Play App Signingの使用
    • ストアの表示の管理
• 設定ファイルの形式（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を訪問する