App Store Connect管理服务器

App Store连接MCP服务器

模型上下文协议（MCP）服务器，用于与应用商店连接API交互。此服务器提供用于管理App Store Connect中的应用程序、测试人员、捆绑ID、设备和功能的工具。

概述

App Store Connect MCP服务器是一个全面的工具，弥合了a.I和苹果App Store Connect生态系统之间的差距。该服务器基于模型上下文协议（MCP）构建，使开发人员能够通过对话式人工智能直接与他们的App Store Connect数据进行交互，使应用管理、测试和分析比以往任何时候都更容易访问。

主要优势：

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

这是给谁的：

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

此服务器将复杂的App Store Connect操作转换为简单的对话命令，无论您是在检查应用程序分析、管理beta测试人员，还是在探索您的开发管道。

特性

• 应用程序管理

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

• Beta Testing

  • 列出测试组
  • 列出测试人员
  • 在组中添加/删除测试人员
  • 管理beta测试配置
  • 查看带有屏幕截图和设备信息的测试版反馈

• 捆绑ID管理

  • 列出捆绑包ID
  • 创建新的捆绑包ID
  • 获取捆绑包ID详细信息
  • 启用/禁用功能

• 设备管理

  • 列出已注册的设备
  • 按设备类型、平台、状态筛选
  • 查看设备详细信息

• 用户管理

  • 列出团队成员
  • 查看用户角色和权限
  • 按角色和访问权限筛选用户

• 分析和报告 ✨ 新

  • 为应用程序创建分析报告请求
  • 下载App Store参与度、商务和使用分析
  • 访问性能和框架使用情况报告
  • 下载销售和趋势报告（每日、每周、每月、每年）
  • 按地区下载财务报告

• Xcode开发工具 🔧 新

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

安装

使用Smithery

要自动安装Claude Desktop的App Store Connect服务器，请执行以下操作：

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

手动安装

npm install -g @justthecontent/appstore-connect-mcp-server

npx快速入门

npx -y @justthecontent/appstore-connect-mcp-server

配置

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

macOS

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

视窗

%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "app-store-connect": {
      "command": "npx",
      "args": [
        "-y",
        "@justthecontent/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 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_report, download_finance_report)仅当配置了供应商编号时才可用。您可以在App Store Connect的“销售和趋势”或“付款和财务报告”下找到您的供应商编号。

示例行为：

• ✅ 带有供应商编号：所有可用的分析+销售/财务工具
• ⚠️ 无供应商编号：只有分析工具可用（销售/财务工具隐藏）

可用工具

应用程序管理

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

Beta Testing

• list_beta_groups：列出所有beta测试组
• 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费率限制
• 网络问题
• 无效操作

发展

# Install dependencies
npm install

# Build the project
npm run build

# Run tests
npm test

# Run type checking
npm run type-check

许可证

此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。

相关链接

• 模型上下文协议文档
• App Store Connect API文档
• MCP TypeScript SDK