TA

trialanderrorai/appstore-connect-mcp

API 开发

本页由 AI 翻译,技术细节请以原文为准。 查看原文

36 stars 6 forks 质量 77 趋势 16MIT

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账号

  1. 访问应用商店连接→用户,访问→集成→密钥
  2. 点击“+”生成新密钥(管理员或财务角色)
  3. 下载.p8文件(仅可下载一次!)
  4. 注明你的密钥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

  1. Go to App Store Connect → Users and Access → Integrations → Keys
  2. Click “+” to generate a new key (Admin or Finance role)
  3. Download the .p8 file (only downloadable once!)
  4. 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",
在 GitHub 查看完整 README

安装

npx -y @trialanderror-ai/appstore-connect-mcp
新手?先看 mcpskill.org 教程 →

配置

{ "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" } } } }