asc-mcp-server

🍏 App Store Connect MCP 服务

一个功能强大的 Model Context Protocol (MCP) 服务，可让你直接通过 AI 助手（Claude、Gemini 等）管理 iOS 应用发布、TestFlight 分发、屏幕截图和审核提交。

无需再花 20 分钟在 App Store Connect 中逐个点击，只为提交一个新版本。让你的 AI Agent 处理部署流程。

“Claude，将最新构建分发给 Internal Testers 群组。” “Gemini，创建版本 2.1.0，附加最新构建并提交审核。” “Claude，我们上次被 App Store 拒绝的原因是什么？”

---

🌟 主要功能

• 🚀 端到端发布： 创建版本、分配构建、更新“更新内容”，并提交审核。
• ✈️ TestFlight 自动化： 将构建分发到测试群组并管理测试人员。
• 🖼️ 元数据与屏幕截图： 更新应用描述、关键词、隐私政策，以及上传／删除屏幕截图。
• 📊 财务与销售： 获取每日／每周销售数据和财务报告。
• 🛡️ 提交前检查： 内置错误处理和提交前验证。

🛠️ 提供的工具

📦 应用与元数据

• asc_list_apps - 列出你账户下的所有应用
• asc_get_app_info - 查看应用详细信息（隐私政策、年龄分级、本地化内容）
• asc_update_app_info_localization - 按地区更新隐私政策 URL、名称和副标题

🚀 版本与发布

• asc_list_versions - 获取所有版本及其状态（LIVE、DRAFT、REJECTED 等）
• asc_create_version - 创建新的 App Store 版本
• asc_update_whats_new - 批量更新所有地区的“更新内容”
• asc_update_version_localization - 更新单个地区的元数据（描述、关键词）
• asc_get_version_localizations - 查看所有地区的元数据
• asc_assign_build - 将 TestFlight 构建附加到某个版本

✈️ 构建与 TestFlight

• asc_list_builds - 查看近期构建及其处理状态
• asc_get_build_details - 查看构建详细信息
• asc_list_beta_groups - 列出 TestFlight 测试群组
• asc_add_build_to_beta_group - 将构建分发到指定的测试人员群组
• asc_set_testflight_whats_new - 设置 TestFlight 发布说明
• asc_get_testflight_feedback - 获取测试人员的屏幕截图和崩溃反馈（文本、设备、OS、测试人员、构建），供 AI Agent 进行分类处理

🔍 审核与提交

• asc_get_review_submission - 检查审核状态、演示账户和拒绝信息
• asc_update_review_detail - 设置演示账户、审核人员备注和联系信息
• asc_submit_for_review - 提交版本进行审核（含提交前检查）
• asc_get_rejection_reasons - 查看近期拒绝原因及其解决方案

📊 报告

• asc_sales_report - 销售数据（每日／每周／每月）
• asc_financial_report - 按地区查看财务报告

📸 屏幕截图

• asc_list_screenshot_sets - 查看屏幕截图集
• asc_upload_screenshot - 三步上传自动化（预留、上传、提交）
• asc_upload_screenshots_batch - 一次调用即可批量上传多个地区的整组屏幕截图；自动查找或创建每组并先清空（刷新 7 个地区、每个地区 9 张图片只需调用 1 次，而非约 70 次）
• asc_delete_screenshot - 删除单张屏幕截图
• asc_delete_all_screenshots - 清空整个屏幕截图集

---

⚙️ 快速开始

1. 生成 App Store Connect API 密钥

1. 前往 App Store Connect > Users and Access > Keys。
2. 生成一个具有 App Manager 或 Admin 权限的 App Store Connect API Key。
3. 下载 .p8 文件。你还需要 Key ID 和 Issuer ID。

2. 安装

克隆此仓库并进行构建：

git clone https://github.com/YOUR_USERNAME/asc-mcp-server.git
cd asc-mcp-server
npm install
npm run build

3. 连接到 Claude Code（或任何 MCP 客户端）

使用 claude mcp add 命令将此服务注入 Claude 环境：

claude mcp add asc-mcp -- node /path/to/asc-mcp-server/dist/index.js

然后在 Claude 设置（~/.claude/settings.json）中配置环境变量：

{
  "mcpServers": {
    "asc-mcp": {
      "command": "node",
      "args": ["/path/to/asc-mcp-server/dist/index.js"],
      "env": {
        "APP_STORE_CONNECT_KEY_ID": "YOUR_KEY_ID",
        "APP_STORE_CONNECT_ISSUER_ID": "YOUR_ISSUER_ID",
        "APP_STORE_CONNECT_P8_PATH": "/path/to/AuthKey_YOUR_KEY_ID.p8"
      }
    }
  }
}

---

🤖 AI 工作流示例

1. 新版本发布流程

只需告诉 AI：“为最新构建准备发布。创建版本 2.1.0，附加构建，更新发布说明，设置演示账户密码，然后提交审核。”

AI 将按顺序执行： asc_list_builds -> asc_create_version -> asc_update_whats_new -> asc_assign_build -> asc_update_review_detail -> asc_submit_for_review

2. 处理审核拒绝

“我们的应用为什么被拒绝了？查看拒绝原因，让我修复代码，然后更新审核备注以说明修复内容并重新提交。”

3. 快速推送到 TestFlight

“将最新构建分发给 ‘Internal Testers’ 群组，并将备注设置为 ‘Added dark mode’。”

4. 处理 Beta 反馈

“TestFlight 测试者对最新构建有什么反馈？总结崩溃和投诉。”

AI 将调用 asc_get_testflight_feedback，并为你总结截图和崩溃提交内容。

5. 根据 Git 自动生成发布说明

“查看上一个标签以来的提交记录，根据这些记录撰写用户友好的发布说明（不要使用提交记录里的行话），并将其推送为 What's New 文本。”

AI 会读取本地 Git 历史，起草文案，然后调用 asc_update_whats_new（也可以通过 asc_update_version_localization 遍历每种语言区域）。

6. 刷新 ASO 关键词

“获取我们当前的 App Store 关键词，研究我们所属类别中的热门趋势，并将关键词字段更新为更有力的 100 个字符。”

AI 会调用 asc_get_version_localizations 读取当前关键词，然后调用 asc_update_version_localization 写入新关键词。

7. 自动回复评价

“用真诚、有帮助且富有同理心的回复，回应本周的 1 星和 2 星评价。”

AI 会调用 asc_list_customer_reviews，为每条评价起草回复，然后使用 asc_respond_to_review 逐条发布。

📄 许可证

本项目采用 MIT License 许可，详情请参阅 LICENSE 文件。