Appstoreconnect MCP

App Store连接MCP服务器

模型上下文协议（MCP）服务器，用于访问Apple的App Store Connect API，专门用于Xcode Cloud构建信息。

特性

• 列出Xcode Cloud产品（使用Xcode Cloud配置的应用程序）
• 列出并检查构建运行
• 获取构建操作（构建、测试、归档步骤）
• 查看构建工件和日志
• 获取测试结果
• 列出构建问题（错误和警告）-可用于调试失败的构建

先决条件

• .NET 8.0 SDK或更高版本
• 具有App Store Connect API访问权限的Apple Developer帐户
• App Store Connect API密钥（.p8文件）

获取API密钥

1. 首选 应用商店连接
2. 导航到 用户和访问 → 集成 → 应用商店连接API
3. 点击 生成API密钥 （或使用现有）
4. 下载 .p8 私钥文件（仅可用一次！）
5. 注意 密钥ID 和 发行者ID

Xcode Cloud访问所需权限：

• 应用程序管理员或管理员角色
• 访问要监视的应用程序

安装

下载预构建二进制文件（推荐）

从下载适用于您平台的自包含可执行文件 发布页面:

不。NET安装是必需的-可执行文件是完全自包含的。

# Example: macOS Apple Silicon
curl -L https://github.com/Stig-Johnny/appstoreconnect-mcp/releases/latest/download/appstoreconnect-mcp-osx-arm64.tar.gz | tar xz
chmod +x appstoreconnect-mcp-osx-arm64/AppStoreConnectMcp

从源代码构建

要求。NET 8.0 SDK。

git clone https://github.com/Stig-Johnny/appstoreconnect-mcp.git
cd appstoreconnect-mcp/AppStoreConnectMcp
dotnet publish -c Release -r osx-arm64  # or your platform

配置

服务器需要以下环境变量：

您必须提供 KEY_PATH 或 KEY_CONTENT不是两者都有。

使用Claude代码

添加到您的 .mcp.json 配置：

{
  "mcpServers": {
    "appstoreconnect": {
      "type": "stdio",
      "command": "/path/to/appstoreconnect-mcp-osx-arm64/AppStoreConnectMcp",
      "env": {
        "APP_STORE_CONNECT_KEY_ID": "YOUR_KEY_ID",
        "APP_STORE_CONNECT_ISSUER_ID": "YOUR_ISSUER_ID",
        "APP_STORE_CONNECT_KEY_PATH": "/path/to/AuthKey_XXXX.p8"
      }
    }
  }
}

或者如果从源代码构建。NET安装：

{
  "mcpServers": {
    "appstoreconnect": {
      "type": "stdio",
      "command": "dotnet",
      "args": ["run", "--project", "/path/to/appstoreconnect-mcp/AppStoreConnectMcp"],
      "env": {
        "APP_STORE_CONNECT_KEY_ID": "YOUR_KEY_ID",
        "APP_STORE_CONNECT_ISSUER_ID": "YOUR_ISSUER_ID",
        "APP_STORE_CONNECT_KEY_PATH": "/path/to/AuthKey_XXXX.p8"
      }
    }
  }
}

可用工具

产品列表

列出所有Xcode Cloud产品（使用Xcode Cloud配置的应用程序）。

列表构建

列出特定产品的最新版本。

• productId：产品ID（来自ListProducts）
• limit：要返回的最大内部版本数（默认值：10）

GetBuildRun

获取特定构建运行的详细信息。

• buildRunId：构建运行ID

ListBuildActions

列出构建运行的所有操作（构建、测试、归档步骤）。

• buildRunId：构建运行ID

GetBuildAction

获取特定构建操作的详细信息。

• actionId：动作ID

列出工件

列出构建操作的工件（日志、存档）。

• actionId：动作ID

GetTestResults

获取构建操作的测试结果。

• actionId：动作ID

列表问题

列出生成操作的问题（错误和警告）。这对于调试失败的构建特别有用。

• actionId：动作ID

工作流示例

1. 列出产品 要查找您的应用程序：

   ListProducts

1. 列出最新版本 对于您的产品：

   ListBuilds(productId: "abc123", limit: 5)

1. 获取构建操作 要查找失败的步骤：

   ListBuildActions(buildRunId: "xyz789")

1. 列出问题 查看错误：

   ListIssues(actionId: "action123")

安全须知

• 永远不要承诺你的 .p8 版本控制私钥
• 使用环境变量或安全密钥管理
• API密钥授予对App Store Connect帐户的访问权限
• 考虑使用 KEY_CONTENT 容器化部署的变量

API 文档

此服务器实现了Apple的一个子集 应用商店连接API:

• Xcode云工作流和构建
• ciBuildRuns
• ciBuildActions

许可证

MIT许可证-请参阅 许可证 文件。