应用商店连接-MCP
项目介绍
Apple Store Connect MCP 服务器
这是一个模型上下文协议（MCP）服务器，提供了与Apple Store Connect API交互的工具，通过Claude Desktop或其他MCP客户端管理iOS/macOS应用、TestFlight、应用元数据等。
功能
应用管理
- 列出应用：查看您App Store Connect账户中的所有应用
- 应用信息：获取详细的应用信息，包括状态和元数据
- 应用商店版本：创建和管理应用商店版本
- 本地化：更新不同市场的应用描述和元数据
分析与销售
- 销售数据：检索销售和收入信息
- 分析：访问应用分析，包括安装量和用户参与度
- 客户评论：阅读和分析客户反馈
- 定价信息：查看不同地区的当前应用定价
TestFlight 集成
- 构建管理：查看TestFlight构建及其状态
- 测试组：管理TestFlight测试组
- 测试者管理：添加和管理测试者
其他功能
- 应用内购买：查看和管理应用内购买产品
- 应用可用性：检查不同地区的应用可用性
- 类别与评级：访问应用类别和年龄评级信息
设置
前提条件
- Node.js 18+
- 具有App Store Connect访问权限的Apple开发者账户
- App Store Connect API密钥
App Store Connect API 密钥设置
-
生成API密钥：
- 转到App Store Connect
- 导航至用户和访问 → 集成 → App Store Connect API
- 创建具有适当权限的新API密钥
-
环境变量：
APPLE_KEY_ID=your_key_id APPLE_ISSUER_ID=your_issuer_id APPLE_PRIVATE_KEY="-----BEGIN PRIVATE KEY----- your_private_key_content -----END PRIVATE KEY-----" APPLE_BUNDLE_ID=com.yourcompany.yourapp
安装
# 克隆仓库
git clone https://github.com/ryaker/appstore-connect-mcp.git
cd appstore-connect-mcp
# 安装依赖
npm install
# 构建项目
npm run build
# 启动服务器
npm start
Claude Desktop 配置
在您的Claude Desktop claude_desktop_config.json中添加：
{
"mcpServers": {
"appstore-connect": {
"command": "node",
"args": ["/path/to/appstore-connect-mcp/dist/src/index.js"],
"env": {
"APPLE_KEY_ID": "your_key_id",
"APPLE_ISSUER_ID": "your_issuer_id",
"APPLE_PRIVATE_KEY": "your_private_key",
"APPLE_BUNDLE_ID": "com.yourcompany.yourapp"
}
}
}
}
使用
配置完成后，您可以要求Claude执行以下操作：
- "显示我应用的最新销售数据"
- "列出我的应用的所有TestFlight构建"
- "最近的客户评论是什么？"
- "创建一个新的应用商店版本"
- "将一个测试者添加到我的TestFlight组"
远程部署与OAuth
Auth0 设置（用于远程访问）
-
创建Auth0 API：
- 登录到Auth0仪表板
- 创建新的API（不是应用程序）
- 记下标识符（将成为您的受众）
-
配置OAuth设置：
OAUTH_ENABLED=true
AUTH0_DOMAIN=https://your-tenant.auth0.com
AUTH0_AUDIENCE=https://your-api-identifier
- 部署到Vercel：
vercel --prod
- 配置Claude Desktop以进行远程访问：
{
"mcpServers": {
"appstore-connect": {
"url": "https://your-deployment.vercel.app/mcp"
}
}
}
Claude会自动发现OAuth配置并处理身份验证。
身份验证
此服务器支持两种身份验证模式：
- 本地：直接使用Apple Store Connect API密钥进行身份验证
- 远程：通过Auth0进行安全远程访问的OAuth 2.0
要求
- 有效的Apple开发者计划会员资格
- App Store Connect访问权限
- 具有适当权限的API密钥（通常是应用管理员或管理员）
许可证
MIT许可证 - 详情见LICENSE文件
贡献
欢迎贡献！请阅读我们的贡献指南，并提交改进的拉取请求。
支持
- 创建问题报告错误或功能请求
- 查看Apple的App Store Connect API文档以获取API特定的问题解答