app-publish-mcp 是一个统一的 MCP（Model Context Protocol）服务器，用于通过 AI 助手管理 App Store Connect 和 Google Play Console 的应用上架相关工作。它提供 91 个工具，覆盖应用列表、截图、发布、评论和提交等商店侧操作。
用途：当你需要更新应用商店描述与关键词、上传截图、提交新版本审核、检查审核状态、回复 Google Play 用户评论、创建分阶段发布、管理 TestFlight 测试员、设置应用内购买，或注册开发设备时，可使用该 MCP。
发布边界：你需提供已就绪且正确签名的 Android .aab/.apk 或 Apple .ipa 文件。MCP 处理从上传到元数据、测试、审核提交和发布的受支持商店侧工作，但不编译应用、不持有签名密钥，也不替代 Xcode、Gradle 或 CI。新应用的首次发布仍需在 App Store Connect 或 Play Console 中手动设置，包括开发者注册、协议、所需的应用记录、API 访问、签名、税务和银行信息，以及政策、隐私或内容声明。对于已完整配置的现有 Android 应用，签名 AAB 通常足以让 MCP 运行更新工作流。Google edit commit 仅提交所请求的更改；商店审核、托管发布或分阶段推出仍可能延迟公开可见。
主要能力：Apple App Store Connect 提供 98 个工具，Google Play Console 提供 49 个工具。Apple 方面支持定价管理（apple_get_pricing 跟随手动和自动价格页面；apple_set_price 提交完整手动价格表）、置备资源（Bundle ID、能力、证书、配置文件、设备，需具有适当访问权限的团队 API 密钥）、TestFlight 内部测试员管理等。Google 方面涵盖评论回复（需关联服务账号具有“回复评论”权限，否则返回空数组且不报错）、一次性产品（monetization.onetimeproducts）等。
截图与素材：Apple 截图上传需先通过 apple_get_asset_library 获取素材库 ID，用 apple_get_asset_specs 选择当前规格、兼容的放置类型和放置组，不应猜测设备尺寸或组标识符。apple_upload_asset 接收 assetLibraryId、mediaType（IMAGE 或 VIDEO）、filePath 和 expectedSpecId，会验证文件扩展名/大小、上传所有分片、提交并默认等待处理。apple_create_placement 将素材关联到本地化 ID；apple_reorder_placements 按放置组顺序重排；Apple 已弃用旧版截图端点（App Store Connect API 4.5.1），四个现有截图工具仅为兼容保留。
使用方式：Apple 凭据需在 App Store Connect > Keys 创建具有 App Manager 角色的 API 密钥，下载 .p8，记录 Key ID 和 Issuer ID；团队密钥用于置备资源，个人密钥需设置 APPLE_KEY_TYPE=INDIVIDUAL 并省略 Issuer ID。Google 凭据需启用 Google Play Android Developer API，选择服务账号或 OAuth 认证；OAuth 命令会将刷新令牌存储于 ~/.app-publish-mcp/google.json。服务器自动加载项目根目录的 .env，shell 或 MCP 主机提供的环境变量优先。可添加到 ~/.claude/settings.local.json。
适用场景：iOS 和 Android 应用的上架更新、截图管理、版本提交与审核跟踪、评论回复、测试员管理、应用内购买与订阅设置等。
限制：不编译应用、不持有签名密钥、不替代 Xcode、Gradle 或 CI；首次发布需手动设置；Google edit commit 不保证立即公开可用；价格以微单位表示并通过 Play API 的 Money 结构转换；部分功能依赖特定权限或 API 版本，缺失时可能返回空结果而不报错。
