PubShip

officiel

Serveur MCP open-source pour les flux de travail des développeurs Google Play. Fonctionne localement avec vos propres identifiants.

Que pouvez-vous faire avec PubShip MCP ?

  • Inspectez les versions et avis Play — Demandez à votre assistant de récupérer les informations de version actuelles, les avis utilisateurs et les statistiques Android Vitals pour vos applications.
  • Examinez les rapports groupés ciblés — Faites en sorte que votre assistant récupère et résume les rapports groupés couvrant les données de catalogue, d’abonnement, de produit et de compte.
  • Préparez et mettez en scène les modifications — Demandez à votre assistant de rédiger et de réviser les changements apportés aux fiches d’application ou aux métadonnées, avec des vérifications explicites des autorisations avant exécution.
  • Exécutez les écritures approuvées à usage unique — Demandez à votre assistant d’appliquer une modification préparée une seule fois, en utilisant les autorisations explicites d’application et de méthode que vous avez accordées.
  • Gérez les transferts d’artefacts locaux — Demandez des transferts de fichiers limités entre votre machine et Play, en gardant la publication séparée de la préparation des modifications.

Documentation

PubShip

Les workflows de développement Google Play, depuis votre propre ordinateur. Inspectez les versions, comprenez les avis et les rapports, et préparez des modifications explicitement autorisées depuis votre client MCP.

CI Release AGPL-3.0-only PubShip MCP server – quality and maintenance score on Glama

Démarrage local

Utilisez votre propre compte de service avec les autorisations pour vos applications dans la Play Console. Conservez son fichier JSON privé en dehors de ce dépôt. Accordez uniquement les autorisations nécessaires à vos opérations prévues. Ne collez jamais d'identifiants dans une conversation avec un assistant.

export GOOGLE_APPLICATION_CREDENTIALS=/absolute/private/path/service-account.json
export GOOGLE_PLAY_PACKAGES=com.example.app
uvx pubship

Ceci démarre le serveur stdio, qui attend un client MCP. Pour une vérification d'installation sans identifiants :

uvx pubship --check

Les commandes ci-dessus installent le paquet PyPI publié. Une copie du code source peut contenir des modifications non encore publiées ; après uv sync, utilisez uv run pubship --check pour vérifier la version locale.

Connecter un assistant

Claude Code

claude mcp add --transport stdio pubship -- uvx pubship

Définissez les variables d'environnement ci-dessus dans le shell qui lance votre client. Redémarrez le client après avoir modifié son environnement.

Codex

codex mcp add pubship -- uvx pubship

Cursor et Gemini CLI

Les manifestes clients de ce dépôt déclarent le chemin local de la clé du compte de service et les noms des paquets. Consultez configuration client pour la configuration et la commande d'installation de Gemini CLI. Pour une installation assistée par agent, lisez llms-install.md. Fournissez uniquement le chemin du fichier de clé, jamais son contenu.

Harnais MCP générique

Configurez un serveur stdio avec l'exécutable uvx, l'argument pubship et votre environnement local. Pour les clients nécessitant une configuration explicite :

{
  "mcpServers": {
    "pubship": {
      "command": "uvx",
      "args": ["pubship"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/absolute/private/path/service-account.json",
        "GOOGLE_PLAY_PACKAGES": "com.example.app"
      }
    }
  }
}

La configuration du client reste sur votre ordinateur. Consultez configuration pour les modes d'authentification alternatifs, les API activées, les rapports et les limites d'autorisations.

Que peut-il faire ?

Local API coverage

L'inventaire épinglé contient 172 définitions de méthodes. 170 ont des implémentations, une méthode d'archivage d'abonnements n'est pas prise en charge par Google, et l'accès aux achats annulés est délibérément désactivé par la politique du projet. Les opérations désactivées ne peuvent pas être appelées via les outils locaux ou auto-hébergés.

  • Lisez les versions, les avis, les signaux Android et les rapports groupés ciblés.
  • Inspectez les ressources de catalogue, d'abonnements, de produits et de comptes avec des autorisations distinctes pour les données sensibles.
  • Préparez et révisez les écritures avec des autorisations explicites par application/méthode et une exécution à usage unique.
  • Gardez les transferts de fichiers locaux limités et séparez la publication du staging de modification.

Les lectures sont le comportement par défaut. Les écritures facultatives et les lectures sensibles nécessitent une configuration explicite. Le texte du fournisseur est une donnée non fiable. Une donnée manquante n'est pas zéro ; une modification soumise n'est pas nécessairement publiée. Aucun nombre d'opérations ne constitue une revendication de vérification en direct par Google.

Explorez les contrats et les limites

Auto-hébergement pour vos propres comptes

pubship-server conserve l'implémentation HTTP pour l'infrastructure que vous contrôlez. Il refuse de démarrer sans PUBSHIP_SERVER_ALLOWED_EMAILS. La connexion nécessite un jeton d'identité Google signé, une correspondance exacte vérifiée de l'adresse e-mail et une liaison nonce avant que des identifiants Google ne soient persistés. La suppression d'un compte de la liste autorisée invalide ses autorisations stockées à la prochaine utilisation. Les autorisations héritées sans identité vérifiée doivent se reconnecter. L'inscription reste fermée jusqu'à ce que l'opérateur l'active explicitement.

Il n'existe aucun service connecté à Google géré par le projet. Consultez la décision local-first et la configuration auto-hébergée.

Notes de version

PubShip 0.24.2 améliore les descriptions d'outils et les indices d'approbation, et vérifie les mêmes définitions entre les installations source et empaquetées. Consultez le journal des modifications pour les versions antérieures. Les versions source peuvent précéder la publication du paquet.

Développement

Qualité des définitions d'outils documente les vérifications hors ligne TDQS 1.2, les résultats heuristiques examinés et la couverture de régression des contrats MCP. Le lint hors ligne n'est pas une note attribuée par un modèle.

env -u GOOGLE_APPLICATION_CREDENTIALS uv sync --frozen --all-extras --group browser --group tdqs
env -u GOOGLE_APPLICATION_CREDENTIALS uv run --frozen --all-extras --group browser --group tdqs pytest
env -u GOOGLE_APPLICATION_CREDENTIALS uv run ruff check .
env -u GOOGLE_APPLICATION_CREDENTIALS uv run ruff format --check .
env -u GOOGLE_APPLICATION_CREDENTIALS uv run python scripts/generate_catalog.py --check
env -u GOOGLE_APPLICATION_CREDENTIALS uv run python scripts/generate_verification.py --check
env -u GOOGLE_APPLICATION_CREDENTIALS uv run python scripts/distribution_metadata.py --check
env -u GOOGLE_APPLICATION_CREDENTIALS uv build
env -u GOOGLE_APPLICATION_CREDENTIALS uv run python scripts/check_artifacts.py

Les tests utilisent des fournisseurs fictifs. Les tests navigateur nécessitent les moteurs Playwright installés ; les tests d'intégration de sauvegarde nécessitent age. Enregistrez honnêtement les vérifications de plateformes indisponibles. Consultez politique de contribution, processus de publication et signalement de sécurité.

Utilisation prévue

PubShip aide les développeurs à automatiser leur propre travail de distribution Google Play. Il s'exécute sur votre ordinateur ou sur une infrastructure que vous contrôlez, avec vos propres identifiants Google et autorisations Play Console. Le projet PubShip n'exploite pas de service hébergé et ne reçoit jamais vos identifiants. Utilisez-le uniquement pour les applications et les comptes de développeur que vous ou votre organisation possédez, et respectez les conditions d'utilisation de l'API Play Developer de Google. Les instances PubShip hébergées par d'autres ne sont ni fournies ni approuvées par le projet PubShip.

PubShip est un projet open source indépendant et n'est pas affilié à Google, ni approuvé, ni sponsorisé par Google. Google, Google Play et Android sont des marques commerciales de Google LLC.

Licence

PubShip est un logiciel libre sous la licence publique générale GNU Affero version 3 uniquement (AGPL-3.0-only). Copyright (C) 2026 Denys Vorobyov. Pour d'autres conditions de licence, contactez legal@pubship.dev.

Marques commerciales · Avis tiers · Site web