返回市场
应用商店连接-MCP服务器

应用商店连接-MCP服务器

作者:JoshuaRileyDev148 星标更新:2025-09-02

项目介绍

技术文档摘要

App Store Connect MCP 服务器

一个基于模型上下文协议(MCP)的服务器,用于与App Store Connect API进行交互。该服务器提供了管理App Store Connect中的应用、测试者、包ID、设备、应用元数据和功能的工具。

安装MCP服务器

概述

App Store Connect MCP服务器是一个全面的工具,它弥合了人工智能与Apple的App Store Connect生态系统之间的差距。基于模型上下文协议(MCP),此服务器使开发者能够通过对话式AI直接与App Store Connect的数据进行交互,使得应用程序管理、测试版测试和分析比以往任何时候都更加便捷。

关键优势:

  • 🤖 AI驱动的应用程序管理:使用自然语言来管理iOS和macOS应用程序
  • 📊 全面的分析:访问详细的性能、销售和用户参与度数据
  • 👥 简化测试版测试:高效地管理测试组和测试者
  • 🌍 本地化管理:更新所有语言的应用描述、关键词和元数据
  • 🔧 开发工具集成:列出Xcode项目方案并集成到开发流程中
  • 🔐 安全认证:使用官方App Store Connect API和JWT认证
  • 🚀 实时数据:直接从Apple系统获取最新的信息

适用对象:

  • 在App Store Connect中管理iOS/macOS应用的开发者
  • 协调测试版测试项目的开发团队
  • 分析应用性能和用户参与度的产品经理
  • 管理应用元数据和本地化的营销团队
  • 自动化应用商店工作流的DevOps工程师
  • 任何希望简化Apple开发者体验的人

无论您是检查应用分析、管理测试者、更新应用描述还是探索开发流水线,这个服务器都将复杂的App Store Connect操作转化为简单的对话命令。

<a href="https://glama.ai/mcp/servers/z4j2smln34"><img width="380" height="200" src="https://gips3.baidu.com/it/u=4190586006,4188630837&fm=3081&app=3081&f=PNG?w=760&h=400" alt="app-store-connect-mcp-server MCP服务器" /></a> <a href="https://smithery.ai/server/appstore-connect-mcp-server" style="text-decoration: none;"> <img alt="Smithery 安装" src="https://smithery.ai/badge/appstore-connect-mcp-server" /> </a> MseeP.ai 安全评估徽章

功能

  • 应用管理

    • 列出所有应用
    • 获取详细的应用信息
    • 查看应用元数据和关系
  • 测试版测试

    • 列出测试组
    • 列出测试者
    • 向组添加或移除测试者
    • 管理测试版配置
    • 查看带有截图和设备信息的测试反馈
  • 应用商店版本本地化新功能

    • 创建新的应用商店版本并安排发布时间
    • 列出应用的所有应用商店版本
    • 列出应用版本的所有本地化
    • 获取特定本地化的详细信息
    • 更新应用描述、关键词和促销文本
    • 管理营销和支持URL
    • 更新发布版本的“新内容”文本
  • 包ID管理

    • 列出包ID
    • 创建新的包ID
    • 获取包ID的详细信息
    • 启用/禁用功能
  • 设备管理

    • 列出注册的设备
    • 按设备类型、平台和状态过滤
    • 查看设备详细信息
  • 用户管理

    • 列出团队成员
    • 查看用户角色和权限
    • 按角色和访问权限过滤用户
  • 分析与报告

    • 为应用创建分析报告请求
    • 下载应用商店参与度、商业和使用情况分析
    • 访问性能和框架使用情况报告
    • 下载销售和趋势报告(每日、每周、每月、每年)
    • 按地区下载财务报告
  • Xcode开发工具

    • 列出Xcode项目和工作区中的可用方案
    • 集成到开发流程和CI/CD管道中

安装

使用Smithery

要自动安装App Store Connect服务器到Claude桌面:

npx @smithery/cli install appstore-connect-mcp-server --client claude

手动安装

npm install @joshuarileydev/app-store-connect-mcp-server

配置

在您的Claude桌面配置文件中添加以下内容:

macOS

~/Library/Application Support/Claude/claude_desktop_config.json

Windows

%APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "app-store-connect": {
      "command": "npx",
      "args": [
        "-y",
        "appstore-connect-mcp-server"
      ],
      "env": {
        "APP_STORE_CONNECT_KEY_ID": "YOUR_KEY_ID",
        "APP_STORE_CONNECT_ISSUER_ID": "YOUR_ISSUER_ID",
        "APP_STORE_CONNECT_P8_PATH": "/path/to/your/auth-key.p8",
        "APP_STORE_CONNECT_VENDOR_NUMBER": "YOUR_VENDOR_NUMBER_OPTIONAL"
      }
    }
  }
}

认证

必需配置

  1. App Store Connect生成App Store Connect API密钥
  2. 下载.p8私钥文件
  3. 记录您的密钥ID和发行人ID
  4. 在配置中设置所需的环境变量:
    • APP_STORE_CONNECT_KEY_ID:您的API密钥ID
    • APP_STORE_CONNECT_ISSUER_ID:您的发行人ID
    • APP_STORE_CONNECT_P8_PATH:.p8私钥文件的路径

可选配置以启用销售和财务报告

要启用销售和财务报告工具,还需要:

  • APP_STORE_CONNECT_VENDOR_NUMBER:来自App Store Connect的供应商编号

注意:销售和财务报告工具(如download_sales_reportdownload_finance_report)仅在配置了供应商编号时可用。您可以在App Store Connect的“销售和趋势”或“支付和财务报告”下找到您的供应商编号。

完整工具参考

📱 应用管理工具

list_apps

获取App Store Connect中的所有应用列表。

参数:

  • limit(可选):返回的最大应用数量(默认:100,最大:200)
  • bundleId(可选):按包标识符筛选

示例:

"列出我所有的应用"
"显示包标识符为com.example.myapp的应用"
"获取前50个应用"

get_app_info

获取特定应用的详细信息。

参数:

  • appId(必需):应用的ID
  • include(可选):包含的相关资源(例如,appClips、appInfos、appStoreVersions、betaGroups、builds)

示例:

"获取应用ID123456789的信息"
"显示应用123456789及其测试组和构建"
"获取包括应用商店版本在内的我的应用详细信息"

👥 测试版测试工具

list_beta_groups

列出所有测试组(内部和外部)。

参数:

  • limit(可选):返回的最大组数(默认:100,最大:200)
  • appId(可选):按应用ID筛选

示例:

"显示所有测试组"
"列出应用123456789的测试组"
"获取前20个测试组"

list_group_testers

列出特定测试组中的测试者。

参数:

  • groupId(必需):测试组的ID
  • limit(可选):返回的最大测试者数量(默认:100,最大:200)

示例:

"列出组ABC123中的所有测试者"
"显示组ABC123中的前50个测试者"

add_tester_to_group

向测试组添加新的测试者。

参数:

  • groupId(必需):测试组的ID
  • email(必需):测试者的电子邮件地址
  • firstName(可选):测试者的名
  • lastName(可选):测试者的姓

示例:

"将john@example.com添加到测试组ABC123"
"将John Smith(john@example.com)添加到组ABC123"

remove_tester_from_group

从测试组中移除测试者。

参数:

  • groupId(必需):测试组的ID
  • testerId(必需):测试者的ID

示例:

"从组ABC123中移除测试者XYZ789"
"删除测试者XYZ789从测试组ABC123"

list_beta_feedback_screenshots

列出测试反馈截图提交。

参数:

  • appId(可选):按应用ID筛选
  • bundleId(可选):按包标识符筛选
  • buildId(可选):按构建ID筛选
  • limit(可选):最大结果数(默认:100)
  • includeBuilds(可选):包含构建信息
  • includeTesters(可选):包含测试者信息

示例:

"显示应用123456789的测试反馈截图"
"列出包标识符为com.example.app的反馈截图"
"获取带有测试者信息的构建XYZ的反馈"

get_beta_feedback_screenshot

获取特定测试反馈截图的详细信息。

参数:

  • feedbackId(必需):反馈的ID
  • includeBuilds(可选):包含构建信息
  • includeTesters(可选):包含测试者信息
  • downloadScreenshot(可选):下载截图图像(默认:true)

示例:

"获取反馈截图FEEDBACK123"
"显示反馈FEEDBACK123及其测试者详情"
"从反馈FEEDBACK123下载截图"

🌍 应用商店版本本地化工具

create_app_store_version

为应用创建新的应用商店版本。

参数:

  • appId(必需):应用的ID
  • platform(必需):平台(IOS、MAC_OS、TV_OS、VISION_OS)
  • versionString(必需):版本字符串,格式为X.Y或X.Y.Z(例如,'1.0'或'1.0.0')
  • copyright(可选):此版本的版权文本
  • releaseType(可选):应用应如何发布(MANUAL、AFTER_APPROVAL、SCHEDULED)
  • earliestReleaseDate(可选):ISO 8601日期字符串(当releaseType为SCHEDULED时需要)
  • buildId(可选):与此版本关联的构建ID

示例:

"为应用123456789创建iOS版本2.0.0"
"为应用123456789创建macOS版本1.5.0,手动发布"
"为应用123456789创建计划于2024-02-01发布的iOS版本2.1.0"
"为应用123456789创建版本1.2.0,构建BUILD456,版权'2024 My Company'"

list_app_store_versions

获取特定应用的所有应用商店版本。

参数:

  • appId(必需):应用的ID
  • limit(可选):返回的最大版本数(默认:100,最大:200)
  • filter(可选):筛选选项
    • platform:按平台筛选(IOS、MAC_OS、TV_OS)
    • versionString:按版本字符串筛选(例如,'1.0.0')
    • appStoreState:按状态筛选(例如,READY_FOR_SALE、PREPARE_FOR_SUBMISSION)

示例:

"列出应用123456789的所有版本"
"显示应用123456789的iOS版本"
"查找应用123456789的版本2.0.0"
"列出应用123456789的审核版本"

list_app_store_version_localizations

获取特定应用商店版本的所有本地化。

参数:

  • appStoreVersionId(必需):应用商店版本的ID
  • limit(可选):返回的最大本地化数(默认:100,最大:200)

示例:

"列出应用版本VERSION123的所有本地化"
"显示应用商店版本VERSION123的语言版本"

get_app_store_version_localization

获取特定本地化的详细信息。

参数:

  • localizationId(必需):本地化的ID

示例:

"获取本地化LOCALE123的详细信息"
"显示法语本地化LOCALE123"

update_app_store_version_localization

更新应用商店版本本地化的特定字段。

参数:

  • localizationId(必需):本地化的ID
  • field(必需):要更新的字段(description、keywords、marketingUrl、promotionalText、supportUrl、whatsNew)
  • value(必需):字段的新值

示例:

"将本地化LOCALE123的描述更新为'惊人的新应用描述'"
"将本地化LOCALE123的关键词更改为'生产力、任务、组织'"
"将本地化LOCALE123的'新内容'文本更新为'错误修复和性能改进'"

🔤 包ID管理工具

create_bundle_id

注册一个新的包ID用于应用开发。

参数:

  • identifier(必需):包ID字符串(例如,'com.example.app')
  • name(必需):包ID的名称
  • platform(必需):平台(IOS、MAC_OS或UNIVERSAL)
  • seedId(可选):您的团队种子ID

示例:

"为iOS创建包ID com.mycompany.newapp,命名为'My New App'"
"注册通用包ID com.example.app,称为'Example App'"

list_bundle_ids

查找并列出注册到您团队的包ID。

参数:

  • limit(可选):最大结果数(默认:100,最大:200)
  • sort(可选):排序顺序(name、-name、platform、-platform、identifier、-identifier)
  • filter(可选):按标识符、名称、平台或seedId筛选
  • include(可选):包含相关资源(profiles、bundleIdCapabilities、app)

示例:

"列出所有包ID"
"按名称排序显示iOS包ID"
"查找包含'example'的包ID"

get_bundle_id_info

获取特定包ID的详细信息。

参数:

  • bundleIdId(必需):包ID的ID
  • include(可选):包含的相关资源
  • fields(可选):要包含的具体字段

示例:

"获取包ID BUNDLE123的信息"
"显示包ID BUNDLE113及其功能"

enable_bundle_capability

为包ID启用功能。

参数:

  • bundleIdId(必需):包ID的ID
  • capabilityType(必需):功能类型(例如,PUSH_NOTIFICATIONS、ICLOUD、GAME_CENTER)
  • settings(可选):功能特定设置

示例:

"为包ID BUNDLE123启用推送通知"
"为包BUNDLE123添加iCloud功能"
"为包ID BUNDLE123启用游戏中心"

disable_bundle_capability

为包ID禁用功能。

参数:

  • capabilityId(必需):要禁用的功能ID

示例:

"禁用功能CAP123"
"从包ID移除功能CAP123"

📱 设备管理工具

list_devices

获取注册到您团队的所有设备列表。

参数:

  • limit(可选):最大结果数(默认:100,最大:200)
  • sort(可选):排序顺序(name、platform、status、udid、deviceClass、model、addedDate)
  • filter(可选):按名称、平台、状态、udid或deviceClass筛选
  • fields(可选):要包含的具体字段

示例:

"列出所有设备"
"显示