appstore-connect-mcp

Name: appstore-connect-mcp
Author: ryaker

本地服务

github.com/ryaker开发工具559 周前更新

代码仓库

关于 appstore-connect-mcp

App Store Connect MCP 服务将 AI 助手连接到 Apple App Store Connect API，可在 Claude Desktop、Cursor、Windsurf 和 VS Code 等客户端中使用。适合 iOS 应用开发者管理 TestFlight、评论与销售数据。

主要功能

01查看应用及版本状态
02管理 TestFlight 构建与测试组
03读取、总结并起草用户评论回复
04获取下载量、收入与地区表现数据
05支持本地 API Key 与 OAuth 2.0 认证

适用场景

01查看 TestFlight 构建及其处理状态
02总结近期应用商店的低分评论
03更新指定版本的发布说明

MCP 相关

该项目是 MCP 服务，向 MCP 客户端提供 App Store Connect 相关功能，并可通过 npx 直接运行。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "ryaker-appstore-connect": {
      "command": "npx",
      "args": [
        "-y",
        "@ryaker/appstore-connect-mcp"
      ],
      "env": {
        "APPLE_KEY_ID": "<APPLE_KEY_ID>",
        "APPLE_ISSUER_ID": "<APPLE_ISSUER_ID>",
        "APPLE_PRIVATE_KEY": "<APPLE_PRIVATE_KEY>",
        "APPLE_BUNDLE_ID": "<APPLE_BUNDLE_ID>",
        "APPLE_APP_STORE_ID": "<APPLE_APP_STORE_ID>",
        "OAUTH_ENABLED": "<OAUTH_ENABLED>",
        "OAUTH_ISSUER": "<OAUTH_ISSUER>",
        "OAUTH_AUDIENCE": "<OAUTH_AUDIENCE>",
        "OAUTH_JWKS_URI": "<OAUTH_JWKS_URI>",
        "SERVER_URL": "<SERVER_URL>"
      }
    }
  }
}

启动命令npx -y @ryaker/appstore-connect-mcp

需要配置的环境变量

APPLE_KEY_ID密钥Apple App Store Connect API Key ID

APPLE_ISSUER_ID密钥Apple App Store Connect Issuer ID

APPLE_PRIVATE_KEY密钥Apple App Store Connect Private Key (base64 encoded or raw)

APPLE_BUNDLE_IDOptional: Specific Bundle ID to filter apps

APPLE_APP_STORE_IDOptional: Specific App Store ID

OAUTH_ENABLED密钥Enable OAuth authentication (true/false)

OAUTH_ISSUER密钥OAuth issuer URL (e.g., https://your-tenant.auth0.com)

OAUTH_AUDIENCE密钥OAuth audience URL

OAUTH_JWKS_URI密钥OAuth JWKS URI for token validation

SERVER_URLServer URL for OAuth deployment

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@ryaker/appstore-connect-mcp1.0.0stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

🍎 App Store Connect MCP 服务

一款 Model Context Protocol（MCP）服务，可将 Claude Desktop、Cursor、Windsurf 和 VS Code 等 AI 助手连接到 Apple App Store Connect API。

在 AI 编码工作流中直接自动化 TestFlight 构建、客户评论分析、应用元数据更新和销售报告。

💡 快速开始（npx）

无需克隆或手动构建！你可以直接使用 npx 运行此 MCP 服务。

1. 生成 App Store Connect API 密钥

登录 App Store Connect。
前往 用户与访问 ➔ 集成 ➔ App Store Connect API。
点击 生成 API 密钥（建议使用 Admin 或 App Manager 角色）。
下载 .p8 密钥文件，并记下你的 Key ID 和 Issuer ID。

2. 添加到你的 MCP 客户端

🟢 Claude Desktop

将以下内容添加到 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "appstore-connect": {
      "command": "npx",
      "args": ["-y", "@ryaker/appstore-connect-mcp"],
      "env": {
        "APPLE_KEY_ID": "YOUR_KEY_ID",
        "APPLE_ISSUER_ID": "YOUR_ISSUER_ID",
        "APPLE_PRIVATE_KEY": "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----"
      }
    }
  }
}

⚡ Cursor 将以下内容添加到 ~/.cursor/mcp.json，或前往 Cursor 设置 ➔ 功能 ➔ MCP：

{
  "mcpServers": {
    "appstore-connect": {
      "command": "npx",
      "args": ["-y", "@ryaker/appstore-connect-mcp"],
      "env": {
        "APPLE_KEY_ID": "YOUR_KEY_ID",
        "APPLE_ISSUER_ID": "YOUR_ISSUER_ID",
        "APPLE_PRIVATE_KEY": "YOUR_PRIVATE_KEY_BASE64_OR_RAW"
      }
    }
  }
}

🏄 Windsurf 将以下内容添加到 ~/.codeium/windsurf/mcp_config.json：

JSON
{
  "mcpServers": {
    "appstore-connect": {
      "command": "npx",
      "args": ["-y", "@ryaker/appstore-connect-mcp"],
      "env": {
        "APPLE_KEY_ID": "YOUR_KEY_ID",
        "APPLE_ISSUER_ID": "YOUR_ISSUER_ID",
        "APPLE_PRIVATE_KEY": "YOUR_PRIVATE_KEY"
      }
    }
  }
}

🛠️ 功能 📱 应用管理：查看应用、查询版本状态、编辑本地化内容和发行说明。

✈️ TestFlight 集成：列出构建、管理 Beta 测试群组，以及添加/移除 Beta 测试人员。

💬 客户评论：阅读、总结用户评论并起草回复。

📊 分析与销售：获取下载量、收入指标和地区表现。

🔐 双重身份验证支持：支持直接使用本地 API 密钥进行身份验证，或使用远程 OAuth 2.0（通过 Auth0）进行身份验证。

💬 示例提示词完成配置后，可以尝试向 AI 助手提问：

“显示我的应用最新的 TestFlight 构建及其处理状态。”

“App Store 上最新的 1 星评论有哪些？请总结用户的投诉。”

“将版本 1.2.0 的发行说明更新为英语（美国）。”

“总结过去 14 天的应用下载量。”

🔑 环境变量

变量	必需	描述
`APPLE_KEY_ID`	是	你的 App Store Connect API Key ID
`APPLE_ISSUER_ID`	是	你的 App Store Connect Issuer ID
`APPLE_PRIVATE_KEY`	是	`.p8` 密钥的原始 PEM 内容或 Base64 编码字符串
`APPLE_BUNDLE_ID`	可选	将工具范围限制为特定的应用 Bundle ID
`APPLE_APP_STORE_ID`	可选	将工具范围限制为特定的 App Store ID
`OAUTH_ENABLED`	可选	如果通过 OAuth 2.0 将其部署为远程服务，请设置为 `true`

💻 本地开发如果你想在本地贡献或修改源代码：

Bash

# 1. Clone repo
git clone [https://github.com/ryaker/appstore-connect-mcp.git](https://github.com/ryaker/appstore-connect-mcp.git)
cd appstore-connect-mcp

# 2. Install & build
npm install
npm run build

# 3. Test locally
npm start

🤝 贡献与支持欢迎针对 Bug、缺少的 App Store Connect 端点或功能请求提交 Issue！

许可证：MIT

支持 Markdown

登录后评论