App Store Connect MCP 服务器

一个用于与 App Store Connect API 交互的模型上下文协议（MCP）服务器。该服务器提供管理 App Store Connect 中的应用、测试者、捆绑 ID、设备和功能等工具。

概述

App Store Connect MCP 服务器是一个综合工具，用于连接人工智能（A.I）与苹果的 App Store Connect 生态系统。基于模型上下文协议（MCP）构建，该服务器使开发者能够通过对话式人工智能直接与其 App Store Connect 数据交互，使应用管理、测试和数据分析比以往任何时候都更加便捷。

主要优势：

🤖 AI 驱动应用管理：使用自然语言管理您的 iOS 和 macOS 应用
📊 全面数据分析：访问详细的应用性能、销售和用户参与数据
👥 简化测试管理：高效管理测试组和测试者
🔧 开发者工具集成：列出 Xcode 项目方案并集成开发工作流
🔐 安全认证：使用官方 App Store Connect API 和 JWT 认证
🚀 实时数据：直接从苹果系统获取最新信息

适用对象：

在 App Store Connect 中管理应用的 iOS/macOS 开发者
协调测试计划的开发团队
分析应用性能和用户参与的产品经理
自动化应用商店工作流的 DevOps 工程师
任何希望简化其苹果开发者体验的人

该服务器将复杂的 App Store Connect 操作转化为简单的对话指令，无论是检查应用分析、管理测试者还是探索开发流程。

功能

应用管理
- 列出所有应用
- 获取详细应用信息
- 查看应用元数据和关系
测试管理
- 列出测试组
- 列出测试者
- 将测试者添加/移除到组
- 管理测试配置
- 查看带截图和设备信息的测试反馈
捆绑 ID 管理
- 列出捆绑 ID
- 创建新的捆绑 ID
- 获取捆绑 ID 详细信息
- 启用/禁用功能
设备管理
- 列出注册设备
- 按设备类型、平台、状态筛选
- 查看设备详细信息
用户管理
- 列出团队成员
- 查看用户角色和权限
- 按角色和访问权限筛选用户
数据分析和报告 ✨ 新增
- 为应用创建数据分析请求
- 下载 App Store 参与度、交易和使用数据分析
- 访问性能和框架使用报告
- 下载销售和趋势报告（每日、每周、每月、每年）
- 按区域下载财务报告
Xcode 开发工具 🔧 新增
- 列出 Xcode 项目和工作区中的可用方案
- 与开发工作流和 CI/CD 管道集成

安装

使用 Smithery

要自动安装 App Store Connect 服务器：

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

手动安装

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

配置

将以下内容添加到您的 Claude Desktop 配置文件：

macOS

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

Windows

%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "app-store-connect": {
      "command": "npx",
      "args": [
        "-y",
        "@joshuarileydev/app-store-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"
      }
    }
  }
}

认证

必要配置

从 App Store Connect 生成 App Store Connect API 密钥
下载 .p8 私钥文件
记录您的 Key ID 和 Issuer ID
在配置中设置必要的环境变量：
- APP_STORE_CONNECT_KEY_ID：您的 API Key ID
- APP_STORE_CONNECT_ISSUER_ID：您的 Issuer ID
- APP_STORE_CONNECT_P8_PATH：您的 .p8 私钥文件路径

可选配置（用于销售和财务报告）

要启用销售和财务报告工具，您还需要：

APP_STORE_CONNECT_VENDOR_NUMBER：您的 App Store Connect 供应商编号

注意：销售和财务报告工具（download_sales_report、download_finance_report）只有在配置了供应商编号时才可用。您可以在 App Store Connect 的“销售和趋势”或“支付和财务报告”中找到您的供应商编号。

示例行为：

✅ 配置供应商编号：所有分析工具 + 销售/财务工具可用
⚠️ 未配置供应商编号：仅分析工具可用（销售/财务工具隐藏）

可用工具

应用管理

list_apps：获取 App Store Connect 中的应用列表
get_app_info：获取特定应用的详细信息

测试管理

list_beta_groups：列出所有测试组
list_group_testers：列出特定测试组中的测试者
add_tester_to_group：将新测试者添加到测试组
remove_tester_from_group：从测试组中移除测试者
list_beta_feedback_screenshots：列出带截图的测试反馈（支持应用 ID 和捆绑 ID）

捆绑 ID 管理

list_bundle_ids：列出所有注册的捆绑 ID
create_bundle_id：注册新的捆绑 ID
get_bundle_id_info：获取捆绑 ID 详细信息
enable_bundle_capability：为捆绑 ID 启用功能
disable_bundle_capability：为捆绑 ID 禁用功能

设备管理

list_devices：列出所有注册设备（支持筛选）

用户管理

list_users：列出所有团队成员（支持角色筛选）

数据分析和报告 ✨ 新增

create_analytics_report_request：为应用创建新的数据分析请求
list_analytics_reports：获取请求可用的数据分析报告
list_analytics_report_segments：获取特定数据分析报告的片段
download_analytics_report_segment：下载数据分析报告片段的数据

销售 & 财务报告 💰 条件性

这些工具只有在配置了 APP_STORE_CONNECT_VENDOR_NUMBER 时才可用

download_sales_report：下载销售和趋势报告（支持不同频率）
download_finance_report：下载特定区域的财务报告

Xcode 开发工具 🔧 新增

list_schemes：列出 Xcode 项目或工作区中的所有可用方案

错误处理

服务器实现了以下错误处理：

无效认证
缺少必要参数
API 速率限制
网络问题
无效操作

开发

# 安装依赖
npm install

# 构建项目
npm run build

# 运行测试
npm test

# 运行类型检查
npm run type-check

许可证

本项目根据 MIT 许可证授权 - 详细内容请参阅 LICENSE 文件。

JoshuaRileyDev/app-store-connect-mcp-server

星标增长

证据时间轴