Heimdall

Name: Heimdall
Author: erayendes

本地服务

github.com开发工具532 天前更新

代码仓库访问官网

关于 Heimdall

Heimdall 是面向 App Store Connect 的本地 MCP 服务，覆盖 App Store Connect API 和 App Store Server API（StoreKit 2）。它按配置档组织 API 工具，并在高风险变更前要求确认，适合管理应用发布与商店数据的开发者。

主要功能

01覆盖 App Store Connect 与 StoreKit 2 API
02929 个工具，按配置档组织
03配置档可按需增删
04从 Keychain 读取 API 密钥
05高风险变更前显示内容并确认

适用场景

01查看 TestFlight 构建与审核状态
02管理订阅、应用内购买和定价
03汇总评论并起草回复
04管理版本发布、截图与销售报告

MCP 相关

作为本地 MCP 服务，向 MCP 客户端提供 App Store Connect API 和 App Store Server API（StoreKit 2）的工具。它直接与 Apple 通信，并可按配置档选择提供的工具。

配置

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

mcp.json · 通用配置

{
  "mcpServers": {
    "erayendes-asc": {
      "command": "npx",
      "args": [
        "-y",
        "@erayendes/asc-mcp"
      ],
      "env": {
        "ASC_KEY_ID": "<ASC_KEY_ID>",
        "ASC_ISSUER_ID": "<ASC_ISSUER_ID>",
        "ASC_PRIVATE_KEY": "<ASC_PRIVATE_KEY>",
        "ASC_PRIVATE_KEY_PATH": "<ASC_PRIVATE_KEY_PATH>",
        "ASC_BUNDLE_ID": "<ASC_BUNDLE_ID>"
      }
    }
  }
}

启动命令npx -y @erayendes/asc-mcp

需要配置的环境变量

ASC_KEY_ID密钥App Store Connect API Key ID. Normally written for you by `npx -y @erayendes/asc-mcp setup`.

ASC_ISSUER_IDApp Store Connect Issuer ID (a UUID). Normally written for you by `setup`.

ASC_PRIVATE_KEY密钥The .p8 private key as PEM text. Prefer `setup`, which stores it in the macOS Keychain instead of any config file; set this only where a Keychain is unavailable, such as CI.

ASC_PRIVATE_KEY_PATH密钥Path to the .p8 file, as an alternative to pasting its contents. Off macOS this is what `setup` records.

ASC_BUNDLE_IDBundle ID of one app. Only needed by the StoreKit 2 transaction tools on the monetization profile.

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

安装包

npm@erayendes/asc-mcp2.8.0stdio

工具

还没有获取到工具列表

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

详细介绍

Heimdall — App Store Connect MCP

整个 App Store Connect 账户，一个工具搞定。

🇬🇧 English · 🇹🇷 Türkçe

开口询问，它就会回答；交代任务，它就会完成。

“总结本周的 1 星评价并起草回复。”

“哪些构建版本卡在审核中了？”

“把这个订阅在每个国家的价格都调高。”

“这个订阅在每个国家的价格是多少？”

“商店页面上有哪些截图？”

“将构建版本 42 添加到 Internal 和 External 群组。”

“我的 Xcode Cloud 构建为什么失败了？”

几乎所有你会在 App Store Connect 中点击操作的事情，现在都可以直接让 AI 帮你完成。更多示例请参见指南。

_{真实的 AI 会话，经过加速处理。App Store Connect 账户为虚构账户，以便公开这段录制内容。}

Heimdall

一个 MCP 服务，同时支持 App Store Connect API 和 App Store Server API（StoreKit 2），基于 Apple 自己的 OpenAPI 规范构建。13 个配置组、33 个子配置组、929 个工具。

Apple 的规范列出了 1011 个 API 操作。Heimdall 排除了 Apple 已弃用的 123 个操作，因此其中 888 个成为工具，并另外添加了 41 个手写工具：总计 929 个工具。

大多数 App Store Connect MCP 服务只提供 API 中精挑细选的一部分。这样通常够用，直到你需要那个被遗漏的端点，然后你又得开始寻找另一个工具。

Heimdall 反其道而行：它提供完整 API，并按配置组整理。 App 和元数据、版本、TestFlight、订阅和 App 内购买、定价、评价、Game Center、Xcode Cloud、配置文件、Webhook、销售和财务报告——应有尽有。你可以选择所需内容，并随时添加或移除配置组。

配置组介绍了每个配置组涵盖的内容。不过你不必记住这些：只要询问*“有处理 App 内活动的工具吗？”*，Heimdall 就会告诉你它属于哪个配置组。

不确定需要哪些配置组？入门套装会根据你的角色推荐一组配置。

在你的电脑上运行

大多数 MCP 指南都推荐使用远程 HTTP 服务。 **而 Heimdall 在本地运行。**它从 Keychain 读取你的 App Store Connect 密钥，签署短期有效的令牌，然后直接与 Apple 通信。中间没有其他环节，因此你的密钥始终由你掌控。

说明

为密钥授予能够完成工作的最小权限。角色介绍了每种 App Store Connect 角色的权限。

在进行高风险更改前询问

更改价格、授予他人管理员权限或删除内容前，Heimdall 会要求你确认，并显示将要发生的更改。对于难以撤销的更改，此功能默认开启：收入、删除、基础设施和访问权限；以及会影响用户的发布步骤：将版本送审、发布版本、更改分阶段发布，以及向外部测试人员开放构建版本。其他操作都遵循你应用自身的审批流程。

更多信息请参阅安全。

与 Fastlane 协同工作

Heimdall 不会取代 Fastlane；它会与 Fastlane 相辅相成。Fastlane 负责流水线，Heimdall 负责其他你原本需要手动完成的工作。

设置

只需一条命令：

npx -y @erayendes/asc-mcp setup

设置向导：密钥、颁发者 ID、凭据检查、配置文件和子配置文件选择，以及将密钥存储在 Keychain 中

它会询问你是要在浏览器中继续（推荐），还是在终端中继续。你需要一个 App Store Connect API 密钥；浏览器页面会根据你的选择告诉你应为其分配什么角色，因此你可以先运行设置，再创建密钥。需要 Node.js 20.19 或更高版本。

想让 AI 替你安装，或在 Xcode 27 中使用它？其他内容请参阅设置。

名称与项目简介

在北欧神话中，Heimdall 守望着 Bifröst，也就是连接 Asgard 与九界的彩虹桥。在这里，它的职责是守护你的 App Store Connect 账户与电脑之间的通道。这就是名称的由来。

Heimdall 由我在业余时间独自开发，并以 MIT 许可证免费开源发布。如果它能让你不必再打开 App Store Connect 控制面板，它就完成了自己的使命。

许可证

Heimdall 根据 Apple Inc. 发布的 App Store Connect OpenAPI 规范生成。App Store Connect、TestFlight、StoreKit、Xcode 和 Game Center 均为 Apple Inc. 的商标。本项目与 Apple Inc. 无关联。

支持 Markdown

登录后评论