MCP Apple Store

Apple App Store Connect API和App Store Server API的MCP服务器

通过模型上下文协议，让克劳德和其他人工智能助手完全访问您的iOS应用程序。

英语 | 葡萄牙语

______________________________________________________________________

这是什么？

mcp-apple-store 是一个 模型上下文协议（MCP）服务器 它将像克劳德这样的人工智能助手直接连接到苹果的开发者API。配置后，您可以使用纯英语管理iOS和macOS应用程序，无需脚本或手动API调用。

它包含两个官方的Apple API：

• 应用商店连接API --管理应用程序、TestFlight构建、配置文件、应用内购买、评论、分析和提交。
• 应用商店服务器API（StoreKit 2） --验证交易、检查订阅状态、查找订单和检索退款历史。

这两个API都公开为 69+MCP工具，每个都可以被任何兼容MCP的客户端发现和调用。

______________________________________________________________________

特性

• 69+MCP工具 涵盖完整的App Store Connect和App Store Server API表面
• 交易和订阅管理 --验证购买、检查活动订阅、检索退款历史记录
• 完整的应用生命周期控制 --创建版本、附加构建、提交审查、管理分阶段发布
• 试飞自动化 --列出构建，管理beta测试人员和beta组
• 资源调配管理 --证书、配置文件、捆绑包ID和设备注册
• 应用内购买管理 --创建和管理IAP、订阅组和订阅
• 客户审核处理 --列出、回复和更新审核回复
• 销售和财务报告 --每日销售、订阅报告和财务数据
• 应用内事件 --创建、更新和发布时间敏感事件
• 安装向导 --交互式CLI，可在几分钟内配置凭据
• 内置速率限制 -遵守苹果API的限制，自动重试和指数退避
• 类型安全 --对所有输入进行Zod验证的完整TypeScript

______________________________________________________________________

支持的API和工具

应用商店服务器API（StoreKit 2）

应用商店连接API

Apps (6 tools)

TestFlight (5 tools)

Provisioning (7 tools)

In-App Purchases (11 tools)

Customer Reviews (7 tools)

Analytics (4 tools)

In-App Events (8 tools)

App Submission (13 tools)

______________________________________________________________________

需求

• Node.js 18+
• Apple 开发者计划 会员资格
• App Store Connect API密钥 （具有适当的角色权限）

API密钥权限

______________________________________________________________________

安装

# Clone the repository
git clone https://github.com/cristianoaredes/mcp-apple-store.git
cd mcp-apple-store

# Install dependencies
npm install

# Run the interactive setup wizard
npm run setup

# Build the project
npm run build

设置向导将引导您在App Store Connect中创建API密钥，并编写 .env 并自动配置Claude Desktop或Claude Code。

手动配置

如果您想跳过向导，请创建一个 .env 项目根目录中的文件：

# App Store Connect API credentials (required)
APP_STORE_ISSUER_ID=your-issuer-id
APP_STORE_KEY_ID=your-key-id
APP_STORE_PRIVATE_KEY_PATH=./keys/AuthKey_XXXXXXXX.p8

# Your app identifiers (required)
APP_BUNDLE_ID=com.yourcompany.yourapp
APP_APPLE_ID=1234567890

# Environment: Production or Sandbox (optional, defaults to Sandbox)
APP_STORE_ENVIRONMENT=Sandbox

______________________________________________________________________

MCP客户端配置

克劳德桌面

将以下内容添加到您的 claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• 视窗: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "apple-store": {
      "command": "node",
      "args": ["/path/to/mcp-apple-store/dist/index.js"],
      "env": {
        "APP_STORE_ISSUER_ID": "your-issuer-id",
        "APP_STORE_KEY_ID": "your-key-id",
        "APP_STORE_PRIVATE_KEY_PATH": "/path/to/AuthKey.p8",
        "APP_BUNDLE_ID": "com.yourcompany.yourapp",
        "APP_APPLE_ID": "1234567890",
        "APP_STORE_ENVIRONMENT": "Sandbox"
      }
    }
  }
}

克劳德代码（CLI）

{
  "mcpServers": {
    "apple-store": {
      "command": "node",
      "args": ["dist/index.js"],
      "cwd": "/path/to/mcp-apple-store",
      "env": {
        "APP_STORE_ISSUER_ID": "your-issuer-id",
        "APP_STORE_KEY_ID": "your-key-id",
        "APP_STORE_PRIVATE_KEY_PATH": "./keys/AuthKey.p8",
        "APP_BUNDLE_ID": "com.yourcompany.yourapp",
        "APP_APPLE_ID": "1234567890"
      }
    }
  }
}

______________________________________________________________________

用法示例

一旦MCP服务器运行并连接到您的AI客户端，您就可以使用简单的英语与Apple的API进行交互。

列出您的应用程序：

List all my apps in App Store Connect

检查订阅状态：

Check if the subscription with transaction ID 1000000123456789 is active

创建订阅组：

Create a subscription group called "Premium" for app 6755709202

创建订阅：

Create a monthly subscription called "Premium Monthly" with product ID
"com.app.premium_monthly" in subscription group 21841364

获取销售报告：

Get the sales report for the last 7 days

注册测试设备：

Register my iPhone with UDID 00008101-001234567890001E as "Dev iPhone 15"

回复评论：

List unanswered reviews for my app and respond to the most recent one-star review

提交审核：

Submit version 2.1.0 of my app for App Store review

______________________________________________________________________

安全

• 永远不要提交API密钥 --the keys/ 目录为gitignored。
• 使用环境变量 --the .env 文件也被gitignored。
• 最小特权 -只使用您实际需要的角色创建API密钥。
• 定期旋转按键尤其是在生产中。

______________________________________________________________________

发展

# Type checking
npm run typecheck

# Run tests
npm test
npm run test:run
npm run test:coverage

# Lint
npm run lint

# Watch mode
npm run dev

______________________________________________________________________

故障排除

“指定的资源不存在” 这通常意味着API URL格式错误。请确保运行的是最新版本。

应用创建时“403禁止” 苹果限制了某些帐户的程序化应用程序创建。首先在app Store Connect中手动创建应用程序，然后将此服务器用于其他所有操作。

速率限制 服务器包含内置的速率限制（Connect API每小时3600次请求）。超过此阈值的请求将以指数回退自动重试。

JWT错误

• 验证您的发卡机构ID（App Store Connect>用户和访问>集成>密钥）
• 确认您的密钥ID与下载的密钥ID匹配 .p8 文件
• 检查一下 APP_STORE_PRIVATE_KEY_PATH 指向可读文件

______________________________________________________________________

贡献

欢迎捐款。请阅读 贡献.md 作为指导方针。

1. 分叉存储库
2. 创建要素分支： git checkout -b feature/my-feature
3. 提交您的更改： git commit -m "add my feature"
4. 推到分支： git push origin feature/my-feature
5. 打开拉取请求

看 ROADMAP.md 对于计划中的功能和良好的首次贡献。

______________________________________________________________________

许可证

麻省理工学院——见 许可证 了解详情。

______________________________________________________________________

专为苹果开发者社区打造。

通过 克里斯蒂亚诺·阿雷德斯