@ggaiteam/appstore-connect-mcp 1.0.0

package/dist/transport.d.ts

@@ -0,0 +1,20 @@
+/**
+ * transport.ts — Transport layer for the MCP server.
+ *
+ * Provides both stdio (local) and Streamable HTTP (remote) transports.
+ */
+import type { Server } from "@modelcontextprotocol/sdk/server/index.js";
+/** Start the server with stdio transport (for local use). */
+export declare function startStdio(server: Server): Promise<void>;
+/** Factory that creates a fresh MCP server per HTTP session. */
+export type ServerFactory = () => Server;
+/**
+ * Start the server with HTTP/SSE transport (for remote deployment).
+ *
+ * Each client session gets its own Server instance + transport pair
+ * (the MCP Server class only supports one transport at a time).
+ *
+ * Includes a health check endpoint at /health.
+ */
+export declare function startHttp(createServer: ServerFactory, host: string, port: number): Promise<void>;
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAExE,6DAA6D;AAC7D,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI9D;AAED,gEAAgE;AAChE,MAAM,MAAM,aAAa,GAAG,MAAM,MAAM,CAAC;AAOzC;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAC7B,YAAY,EAAE,aAAa,EAC3B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAuFf"}

package/dist/transport.js

@@ -0,0 +1,99 @@
+/**
+ * transport.ts — Transport layer for the MCP server.
+ *
+ * Provides both stdio (local) and Streamable HTTP (remote) transports.
+ */
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import express from "express";
+import { randomUUID } from "node:crypto";
+/** Start the server with stdio transport (for local use). */
+export async function startStdio(server) {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("[appstore-connect-mcp] stdio transport ready");
+}
+/**
+ * Start the server with HTTP/SSE transport (for remote deployment).
+ *
+ * Each client session gets its own Server instance + transport pair
+ * (the MCP Server class only supports one transport at a time).
+ *
+ * Includes a health check endpoint at /health.
+ */
+export async function startHttp(createServer, host, port) {
+    const app = express();
+    app.use(express.json({ limit: "50mb" }));
+    // Health check
+    app.get("/health", (_req, res) => {
+        res.json({ status: "ok", server: "appstore-connect-mcp", version: "1.0.0" });
+    });
+    // Session storage — each session has its own server + transport
+    const sessions = new Map();
+    app.post("/mcp", async (req, res) => {
+        try {
+            const sessionId = req.headers["mcp-session-id"];
+            const session = sessionId ? sessions.get(sessionId) : undefined;
+            if (session) {
+                // Existing session — delegate to its transport
+                await session.transport.handleRequest(req, res, req.body);
+            }
+            else {
+                // New session: create server + transport, handle the (initialize) request,
+                // then store the session once its ID is available.
+                const transport = new StreamableHTTPServerTransport({
+                    sessionIdGenerator: () => randomUUID(),
+                });
+                const server = createServer();
+                transport.onclose = async () => {
+                    const sid = transport.sessionId;
+                    if (sid) {
+                        sessions.delete(sid);
+                        await server.close();
+                    }
+                };
+                await server.connect(transport);
+                // handleRequest processes the initialize request and sets the session ID
+                await transport.handleRequest(req, res, req.body);
+                // After the initialize handshake, the session ID is available
+                const newSid = transport.sessionId;
+                if (newSid) {
+                    sessions.set(newSid, { server, transport });
+                }
+            }
+        }
+        catch (err) {
+            console.error("[appstore-connect-mcp] MCP POST error:", err);
+            if (!res.headersSent) {
+                res.status(500).json({ error: "Internal server error" });
+            }
+        }
+    });
+    // SSE streaming endpoint for server-to-client messages
+    app.get("/mcp", async (req, res) => {
+        const sessionId = req.headers["mcp-session-id"];
+        const session = sessionId ? sessions.get(sessionId) : undefined;
+        if (!session) {
+            res
+                .status(400)
+                .json({ error: "No valid session. Send an initialize request first." });
+            return;
+        }
+        await session.transport.handleRequest(req, res);
+    });
+    // Session termination
+    app.delete("/mcp", async (req, res) => {
+        const sessionId = req.headers["mcp-session-id"];
+        const session = sessionId ? sessions.get(sessionId) : undefined;
+        if (!session) {
+            res.status(400).json({ error: "No valid session." });
+            return;
+        }
+        await session.transport.handleRequest(req, res);
+    });
+    app.listen(port, host, () => {
+        console.error(`[appstore-connect-mcp] HTTP transport ready on http://${host}:${port}/mcp`);
+        console.error(`[appstore-connect-mcp] Health check at http://${host}:${port}/health`);
+    });
+}
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Type definitions for the App Store Connect MCP server.
+ */
+/** A single parameter in a tool definition (path or query). */
+export interface ToolParam {
+    name: string;
+    required: boolean;
+    description: string;
+    schema: {
+        type?: string;
+        items?: {
+            type?: string;
+            enum?: string[];
+        };
+        enum?: string[];
+    };
+}
+/** A tool definition generated from the OpenAPI spec. */
+export interface ToolDef {
+    name: string;
+    summary: string;
+    description: string;
+    method: string;
+    path: string;
+    category: string;
+    pathParams: ToolParam[];
+    queryParams: ToolParam[];
+    hasBody: boolean | object;
+}
+/** The overall tools.json structure. */
+export interface ToolsData {
+    "$comment": string;
+    apiVersion: string;
+    baseUrl: string;
+    stats: {
+        total: number;
+        by_method: Record<string, number>;
+    };
+    categories: string[];
+    tools: ToolDef[];
+}
+/** Credentials for App Store Connect API. */
+export interface ASCCredentials {
+    issuerId: string;
+    keyId: string;
+    privateKey: string;
+}
+/** Configuration for the MCP server. */
+export interface ServerConfig {
+    credentials: ASCCredentials;
+    transport: "stdio" | "http";
+    port?: number;
+    host?: string;
+    verbose?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,+DAA+D;AAC/D,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE;QACN,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE;YAAE,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;SAAE,CAAC;QAC3C,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;KACjB,CAAC;CACH;AAED,yDAAyD;AACzD,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,WAAW,EAAE,SAAS,EAAE,CAAC;IACzB,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC;CAC3B;AAED,wCAAwC;AACxC,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;IAC5D,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,EAAE,OAAO,EAAE,CAAC;CAClB;AAED,6CAA6C;AAC7C,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wCAAwC;AACxC,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,cAAc,CAAC;IAC5B,SAAS,EAAE,OAAO,GAAG,MAAM,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB"}

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Type definitions for the App Store Connect MCP server.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@ggaiteam/appstore-connect-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for the Apple App Store Connect API — exposes all 1200+ operations as MCP tools. Supports local (stdio) and remote (HTTP) deployment.",
+  "license": "MIT",
+  "author": "appstore-connect-mcp contributors",
+  "homepage": "https://github.com/topcheer/appstore-connect-mcp",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/topcheer/appstore-connect-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/topcheer/appstore-connect-mcp/issues"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "apple",
+    "app-store-connect",
+    "appstore",
+    "api",
+    "claude",
+    "ai",
+    "llm"
+  ],
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "appstore-connect-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "tsc && node -e \"require('node:fs').copyFileSync('src/tools.json','dist/tools.json')\"",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "start:http": "node dist/index.js --transport http",
+    "start:stdio": "node dist/index.js --transport stdio",
+    "generate": "python3 scripts/generate-tools.py",
+    "prepublishOnly": "npm run build",
+    "lint": "eslint src/ --ext .ts",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "express": "^4.21.2",
+    "jsonwebtoken": "^9.0.2",
+    "zod": "^3.24.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.0",
+    "@types/jsonwebtoken": "^9.0.7",
+    "@types/node": "^22.10.5",
+    "typescript": "^5.7.3"
+  }
+}