使用说明

项目简介

App Store Connect MCP服务器是一个基于Model Context Protocol (MCP) 构建的后端服务,旨在简化与Apple App Store Connect API的交互。它通过MCP协议向客户端暴露一系列工具,允许开发者通过自然语言或程序化方式管理其App Store Connect中的应用、测试用户、Bundle IDs、设备和用户等信息。

主要功能点

  • 应用管理:列出和查看App Store Connect中的应用信息。
  • Beta测试管理:管理应用的Beta测试组和测试用户。
  • Bundle ID管理:创建、列出和查看Bundle ID,以及管理Bundle ID的功能(capabilities)。
  • 设备管理:列出和筛选已注册的开发设备。
  • 用户管理:列出和筛选App Store Connect团队成员。

安装步骤

  1. 确保您的开发环境中已安装 Node.jsnpm
  2. 克隆或下载此GitHub仓库的代码到本地。
  3. 打开命令行终端,导航到仓库根目录。
  4. 运行命令 'npm install' 安装项目依赖。

服务器配置

为了让MCP客户端(例如Claude Desktop)连接到此服务器,您需要在客户端的配置文件中添加服务器配置信息。以Claude Desktop为例,您需要编辑 'claude_desktop_config.json' 文件,该文件通常位于:

  • macOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
  • Windows: '%APPDATA%\Claude\claude_desktop_config.json'

在 'claude_desktop_config.json' 文件的 'mcpServers' 字段中添加以下JSON配置:

{
  "mcpServers": {
    "app-store-connect": {  //  服务器名称,可以自定义,用于在客户端中标识
      "command": "npx",  //  启动服务器的命令,通常使用 npx 来运行 npm 包
      "args": [
        "-y",
        "@your-org/app-store-connect-mcp-server"  //  服务器的 npm 包名,如果已发布到 npm,请替换为实际包名;如果本地运行,可能需要修改为服务器启动脚本的路径
      ],
      "env": {  //  环境变量配置,用于App Store Connect API 认证
        "APP_STORE_CONNECT_KEY_ID": "YOUR_KEY_ID",  //  您的 App Store Connect API 密钥 ID,从 App Store Connect 后台获取
        "APP_STORE_CONNECT_ISSUER_ID": "YOUR_ISSUER_ID",  //  您的 App Store Connect API 颁发者 ID,从 App Store Connect 后台获取
        "APP_STORE_CONNECT_P8_PATH": "/path/to/your/auth-key.p8"  //  您的 App Store Connect API 私钥文件 (.p8) 的路径
      }
    }
  }
}

配置说明

  • 确保您已在 App Store Connect 后台生成 API 密钥,并下载私钥文件 (.p8)。
  • 将 'YOUR_KEY_ID'、'YOUR_ISSUER_ID' 和 '/path/to/your/auth-key.p8' 替换为您的实际 API 密钥信息和私钥文件路径。
  • 如果您将此服务器发布为 npm 包,请将 '@your-org/app-store-connect-mcp-server' 替换为您的实际包名。如果本地运行,您可能需要调整 'command' 和 'args' 配置,例如指向 'node dist/src/index.js'。

基本使用方法

配置完成后,启动MCP客户端(如Claude Desktop)。客户端应该能够自动检测并连接到您配置的 "app-store-connect" MCP服务器。之后,您可以通过客户端提供的界面或指令,调用服务器提供的工具来管理您的 App Store Connect 资源。例如,您可以:

  • 使用 'list_apps' 工具获取您的 App Store Connect 账号下的应用列表。
  • 使用 'list_beta_groups' 工具查看所有 Beta 测试组。
  • 使用 'add_tester_to_group' 工具向指定的 Beta 测试组添加新的测试人员。

具体工具的使用方法和参数,请参考仓库的 'README.md' 文件或工具的 'description' 和 'inputSchema' 定义。

信息

分类

开发者工具