Skip to main content
Glama

appstoreconnect-mcp

Servidor MCP (Model Context Protocol) de solo lectura para la API de App Store Connect de Apple. Transporte local stdio.

Proyecto de VYR TECH SOLUTIONS.

Estado

MVP. La superficie expuesta es de lectura únicamente: el servidor no registra, y no permite registrar, ninguna herramienta de escritura.

Este repositorio recibe el código por ramas (feature/..., fix/...) con PR a main.

Related MCP server: App Store Connect MCP Server

Alcance de esta fase

Incluido

Excluido (fases posteriores)

Transporte stdio local

Transporte HTTP / OAuth (PR upstream #6)

list_apps, get_app

Informes de ventas (get_sales_data, PR upstream #5)

list_app_store_versions

Métricas de analytics

list_builds (TestFlight)

list_beta_groups (TestFlight)

list_customer_reviews

El servidor solo emite peticiones GET contra la API de App Store Connect. El cliente no contiene ningún método que haga POST, PATCH, PUT o DELETE.

Requisitos

  • Node.js >= 18

  • Una clave de API de App Store Connect (.p8) y su issuerId

Instalación

npm install
npm run build

Configuración

Variable

Obligatoria

Descripción

APPLE_KEY_ID

Sí

Key ID de la clave .p8

APPLE_ISSUER_ID

Sí

Issuer ID (team ID) de App Store Connect

APPLE_PRIVATE_KEY

Sí*

Contenido PEM de la clave .p8 (raw o base64)

APPLE_PRIVATE_KEY_PATH

Sí*

Ruta al archivo .p8, en lugar de APPLE_PRIVATE_KEY

APPLE_BUNDLE_ID

No

Restringe el servidor a una app por bundle id

APPLE_APP_STORE_ID

No

Restringe el servidor a una app por App Store id

LOG_LEVEL

No

debug, info, warn o error. Por defecto info

* Configure una de las dos, no ambas.

Las credenciales se dan por variables de entorno o gestor de secretos: nunca se versionan en este repositorio.

Restricción de alcance

Si define APPLE_BUNDLE_ID o APPLE_APP_STORE_ID, el servidor comprueba el alcance de cada app antes de cualquier petición. Una app fuera del alcance se rechaza con un error y no se emite ninguna llamada a la API para ese recurso.

Uso

Como servidor stdio local:

node dist/stdio.js

Configuración de cliente MCP:

{
  "mcpServers": {
    "appstoreconnect": {
      "command": "npx",
      "args": ["-y", "@vyrtech/appstoreconnect-mcp"],
      "env": {
        "APPLE_KEY_ID": "...",
        "APPLE_ISSUER_ID": "...",
        "APPLE_PRIVATE_KEY_PATH": "/ruta/a/la/clave.p8"
      }
    }
  }
}

Transporte stdio

stdout transporta exclusivamente tramas JSON-RPC del protocolo MCP. Todos los diagnósticos, avisos y trazas van a stderr.

La redirección de console a stderr se instala antes de importar cualquier otro módulo, de modo que una dependencia que registre al importarse no puede corromper el flujo del protocolo.

Si falta la configuración obligatoria, el servidor escribe el error en stderr, deja stdout vacío y termina con código distinto de cero.

Herramientas

Todas las herramientas son de lectura.

Herramienta

Argumentos

Devuelve

list_apps

—

Apps visibles en la cuenta

get_app

appId

Una app

list_app_store_versions

appId

Versiones de App Store, más recientes primero

list_builds

appId

Builds de TestFlight, más recientes primero

list_beta_groups

appId

Grupos de beta de TestFlight

list_customer_reviews

appId, limit (opcional, 1–200, por defecto 50)

Reseñas de clientes

Un argumento desconocido o fuera de rango se rechaza antes de emitir cualquier petición de red.

Seguridad de los logs

  • Todos los diagnósticos van a stderr; stdout nunca lleva texto que no sea JSON-RPC.

  • Los valores secretos se redactan antes de escribir: claves con nombre de secreto (privateKey, authorization, token, ...) se sustituyen por una huella no reversible.

  • El material secreto incrustado en texto libre también se redacta: bloques PEM, tokens Bearer y pares clave: valor.

  • Las cadenas largas se truncan.

Desarrollo

npm run build          # compilar a dist/
npm test               # suite completa (mocks y fixtures, sin red)
npx tsc -p tsconfig.test.json   # comprobación de tipos de src/ y test/

La suite usa fixtures y una clave ES256 generada en memoria. No se usa ninguna credencial real de Apple.

Licencia

MIT. Ver LICENSE.

Atribución de upstream y relación con ryaker/appstore-connect-mcp: ver NOTICE.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers