App Store Connect MCP 服务器使用说明

项目简介

本项目是一个MCP服务器，旨在通过Model Context Protocol (MCP) 协议，为LLM应用提供访问Apple App Store Connect API的能力。通过本服务，您可以管理您的App Store应用、Beta测试用户、Bundle IDs、设备以及开发者账户信息。

主要功能点

应用管理:
- 列出所有应用
- 获取应用详细信息
Beta 测试管理:
- 列出 Beta 测试组
- 列出 Beta 测试用户
- 添加测试用户到测试组
- 从测试组移除测试用户
Bundle ID 管理:
- 列出 Bundle IDs
- 创建新的 Bundle ID
- 获取 Bundle ID 详细信息
- 启用 Bundle ID Capability
- 禁用 Bundle ID Capability
设备管理:
- 列出已注册设备 (可按类型、平台、状态过滤)
用户管理:
- 列出团队成员 (可按角色过滤)

安装步骤

请参考仓库的README.md文件中的安装指南。通常可以使用 npm 安装（请注意，可能需要根据实际情况调整安装命令和包名，例如可能需要本地构建后安装）：

npm install @your-org/app-store-connect-mcp-server

服务器配置

要将此 MCP 服务器与 MCP 客户端（例如 Claude Desktop）配合使用，您需要在客户端的配置文件中添加以下服务器配置。

配置示例 (JSON 格式):

{
  "mcpServers": {
    "app-store-connect": {
      "command": "npx",
      "args": [
        "-y",
        "@your-org/app-store-connect-mcp-server"
      ],
      "env": {
        "APP_STORE_CONNECT_KEY_ID": "<你的 App Store Connect API Key ID>",
        "APP_STORE_CONNECT_ISSUER_ID": "<你的 App Store Connect API Issuer ID>",
        "APP_STORE_CONNECT_P8_PATH": "<你的 .p8 密钥文件路径>"
      }
    }
  }
}

配置参数说明:

'"server name"': '"app-store-connect"' (服务器名称，可以自定义)
'"command"': '"npx"' (用于启动服务器的命令，通常为 'npx' 或 'node')
'"args"': 启动参数，
- '"-y"': (可选，根据实际package安装方式确定是否需要)
- '"@your-org/app-store-connect-mcp-server"': (MCP 服务器的包名或入口文件路径，请根据实际安装情况修改)
'"env"': 环境变量配置，用于 App Store Connect API 认证：
- '"APP_STORE_CONNECT_KEY_ID"': [必填] 您的 App Store Connect API Key ID
- '"APP_STORE_CONNECT_ISSUER_ID"': [必填] 您的 App Store Connect API Issuer ID
- '"APP_STORE_CONNECT_P8_PATH"': [必填] 您的 App Store Connect API .p8 密钥文件的绝对路径

重要提示:

您需要在 App Store Connect 中生成 API 密钥 (Key ID, Issuer ID) 并下载 .p8 密钥文件。
请将配置信息添加到您的 MCP 客户端的配置文件中，例如 Claude Desktop 的 'claude_desktop_config.json' 文件。
确保配置中的环境变量值替换为您真实的 API 密钥信息和密钥文件路径。

基本使用方法

配置 MCP 服务器: 按照 "服务器配置" 章节的说明，将服务器配置添加到您的 MCP 客户端。
使用工具: 在您的 LLM 客户端中，可以使用以下工具名称来调用 App Store Connect API 的功能 (工具名称区分大小写):
- 'list_apps' (列出应用)
- 'get_app_info' (获取应用信息)
- 'list_beta_groups' (列出 Beta 测试组)
- 'list_group_testers' (列出测试组用户)
- 'add_tester_to_group' (添加测试用户到测试组)
- 'remove_tester_from_group' (移除测试组用户)
- 'create_bundle_id' (创建 Bundle ID)
- 'list_bundle_ids' (列出 Bundle IDs)
- 'get_bundle_id_info' (获取 Bundle ID 信息)
- 'enable_bundle_capability' (启用 Bundle ID Capability)
- 'disable_bundle_capability' (禁用 Bundle ID Capability)
- 'list_devices' (列出设备)
- 'list_users' (列出用户)
在 LLM 交互中，您可以指示 LLM 使用这些工具来完成 App Store Connect 相关的任务。例如，您可以询问 "列出我所有的 iOS 应用" 或 "添加 '[email protected]' 到 Beta 测试组 'group_id'"。

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

关键词