
App Store Connect 的代码模式 MCP 服务器 — 通过 2 个工具共 923 个端点
概览
传统的MCP服务器将每个API端点包装为独立工具。苹果的App Store Connect API有 。这意味着923个工具定义,~100K+上下文令牌,以及每次苹果添加端点时都会发布新版本。 LLM负责写查询。规范就是实现。添加端点=苹果更新了他们的规范。我们这边代码完全没有更改。 1. 前往应用商店连接→用户,访问→集成→密钥 2.点击“+”生成新密钥(管理员或财务角色)3.下载.p8文件(仅可下载一次!)4. 注明你的密钥ID和发行机构ID。 -s 用户会让你所有项目都能使用服务器。如果你不需要财务报告,就去掉 -e APP_STORE_VENDOR_NUMBER。 或者跳过 env-var 的内联表单,直接在你的 shell / MCP 配置里设置它们(见下文)。 要么在壳壳里设置环境变量,要么通过.mcp.json传递: 添加到 ~/Library/Application Support/Claude/claude_desktop_config.json: 然后把你的MCP配置指向节点/path/to/appstore-connect-mcp/dist/index。
概述(AI 翻译)
923个端点。2个工具。规范就是实现。
问题
传统的MCP服务器将每个API端点包装为独立工具。苹果的App Store Connect API拥有923个端点。这意味着923个工具定义,~100K+上下文令牌,每次苹果添加端点都会有新版本。
解决方案
代码模式:2个工具替换923。
| 工具 | 它的作用 |
|---|---|
search(code) |
写入 JS 查询苹果的 OpenAPI 规范。发现端点,检查参数,读取模式。 |
execute(code) |
写入JS调用API。认证是自动的。串联多次调用。 |
LLM负责写查询。规范就是实现。添加端点=苹果更新了他们的规范。我们这边代码完全没有更改。
快速启动
1.获取App Store Connect账号
- 访问应用商店连接→用户,访问→集成→密钥
- 点击“+”生成新密钥(管理员或财务角色)
- 下载
.p8文件(仅可下载一次!) - 注明你的密钥ID和发行人ID
2.通过 Claude Code 安装
-s user 使服务器在你所有项目中都能使用。如果你不需要财务报表,可以去掉 -e APP_STORE_VENDOR_NUMBER。
本页由 AI 翻译,技术细节请以原文为准。
README
以下为原文 README 节选,完整内容请查看原文。
App Store Connect MCP Server — Code Mode
923 endpoints. 2 tools. The spec IS the implementation.
The Problem
Traditional MCP servers wrap each API endpoint as a separate tool. Apple’s App Store Connect API has 923 endpoints. That means 923 tool definitions, ~100K+ context tokens, and a new release every time Apple adds an endpoint.
The Solution
Code Mode: 2 tools replace 923.
| Tool | What It Does |
|---|---|
search(code) |
Write JS to query Apple’s OpenAPI spec. Discover endpoints, check parameters, read schemas. |
execute(code) |
Write JS to call the API. Auth is automatic. Chain multiple calls. |
The LLM writes the query. The spec IS the implementation. Adding endpoints = Apple updates their spec. Zero code changes on our side.
Traditional MCP: 923 endpoints → 923 tools → ~100K tokens → constant maintenance
Code Mode: 923 endpoints → 2 tools → ~1K tokens → zero maintenance
Quick Start
1. Get App Store Connect credentials
- Go to App Store Connect → Users and Access → Integrations → Keys
- Click “+” to generate a new key (Admin or Finance role)
- Download the
.p8file (only downloadable once!) - Note your Key ID and Issuer ID
2. Install via Claude Code
claude mcp add appstore-connect -s user \
-e APP_STORE_KEY_ID=YOUR_KEY_ID \
-e APP_STORE_ISSUER_ID=YOUR_ISSUER_ID \
-e APP_STORE_P8_PATH=/absolute/path/to/AuthKey_XXXXXXXXXX.p8 \
-e APP_STORE_VENDOR_NUMBER=YOUR_VENDOR_NUMBER \
-- npx -y @trialanderror-ai/appstore-connect-mcp
-s user makes the server available across all your projects. Drop -e APP_STORE_VENDOR_NUMBER if you don’t need financial reports.
Or skip the env-var inline form and set them in your shell / MCP config (see below).
3. Configure credentials
Three required env vars (one optional):
| Variable | Description |
|---|---|
APP_STORE_KEY_ID |
10-character key ID |
APP_STORE_ISSUER_ID |
UUID issuer ID |
APP_STORE_P8_PATH |
Absolute path to your .p8 file |
APP_STORE_VENDOR_NUMBER (optional) |
Required for financial reports |
Configure for Claude Code
Either set env vars in your shell, or pass them via .mcp.json:
{
"mcpServers": {
"appstore-connect": {
"command": "npx",
"args": ["-y", "@trialanderror-ai/appstore-connect-mcp"],
"env": {
"APP_STORE_KEY_ID": "YOUR_KEY_ID",
"APP_STORE_ISSUER_ID": "YOUR_ISSUER_ID",
"APP_STORE_P8_PATH": "/path/to/AuthKey_XXXXXXXXXX.p8",
安装
npx -y @trialanderror-ai/appstore-connect-mcp配置
{
"mcpServers": {
"appstore-connect": {
"command": "npx",
"args": ["-y", "@trialanderror-ai/appstore-connect-mcp"],
"env": {
"APP_STORE_KEY_ID": "YOUR_KEY_ID",
"APP_STORE_ISSUER_ID": "YOUR_ISSUER_ID",
"APP_STORE_P8_PATH": "/path/to/AuthKey_XXXXXXXXXX.p8",
"APP_STORE_VENDOR_NUMBER": "YOUR_VENDOR_NUMBER"
}
}
}
}