@ggaiteam/appstore-connect-mcp 1.0.0

package/dist/index.js

@@ -0,0 +1,129 @@
+#!/usr/bin/env node
+/**
+ * index.ts — Entry point for appstore-connect-mcp.
+ *
+ * Usage:
+ *   # Local (stdio) — for Claude Desktop, Cursor, etc.
+ *   appstore-connect-mcp
+ *   appstore-connect-mcp --transport stdio
+ *
+ *   # Remote (HTTP) — for server deployment
+ *   appstore-connect-mcp --transport http --port 3000 --host 0.0.0.0
+ *
+ * Environment variables:
+ *   APP_STORE_CONNECT_ISSUER_ID    Your App Store Connect issuer ID
+ *   APP_STORE_CONNECT_KEY_ID       Your API key ID
+ *   APP_STORE_CONNECT_PRIVATE_KEY  PEM private key content (alternative: path)
+ *   APP_STORE_CONNECT_P8_FILE      Path to your .p8 private key file
+ *   MCP_TRANSPORT                  'stdio' (default) or 'http'
+ *   MCP_PORT                       HTTP port (default: 3000)
+ *   MCP_HOST                       HTTP host (default: 0.0.0.0)
+ *   MCP_VERBOSE                    Set to '1' for verbose logging
+ */
+import { readFileSync } from "node:fs";
+import { createMcpServer } from "./server.js";
+import { startStdio, startHttp } from "./transport.js";
+import { getToken, parsePrivateKey, validateCredentials } from "./auth.js";
+function parseArgs(argv) {
+    const result = {};
+    for (let i = 2; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg.startsWith("--")) {
+            const key = arg.slice(2);
+            const next = argv[i + 1];
+            if (next && !next.startsWith("--")) {
+                result[key] = next;
+                i++;
+            }
+            else {
+                result[key] = true;
+            }
+        }
+    }
+    return result;
+}
+function loadConfig() {
+    const args = parseArgs(process.argv);
+    // Transport
+    const transport = (args.transport ||
+        process.env.MCP_TRANSPORT ||
+        "stdio");
+    // Credentials
+    const issuerId = args["issuer-id"] ||
+        process.env.APP_STORE_CONNECT_ISSUER_ID ||
+        "";
+    const keyId = args["key-id"] ||
+        process.env.APP_STORE_CONNECT_KEY_ID ||
+        "";
+    // Private key: env var content or file path
+    let privateKey = process.env.APP_STORE_CONNECT_PRIVATE_KEY || "";
+    const p8File = args["p8-file"] ||
+        process.env.APP_STORE_CONNECT_P8_FILE ||
+        "";
+    if (!privateKey && p8File) {
+        privateKey = readFileSync(p8File, "utf-8");
+    }
+    // Also check legacy env var names
+    const legacyKey = process.env.ASC_PRIVATE_KEY || process.env.APPSTORE_CONNECT_PRIVATE_KEY;
+    if (!privateKey && legacyKey) {
+        privateKey = legacyKey;
+    }
+    const credentials = {
+        issuerId,
+        keyId,
+        privateKey: privateKey ? parsePrivateKey(privateKey) : "",
+    };
+    const verbose = args.verbose === true || process.env.MCP_VERBOSE === "1";
+    const port = parseInt(args.port || process.env.MCP_PORT || "3000", 10);
+    const host = args.host || process.env.MCP_HOST || "0.0.0.0";
+    return {
+        credentials,
+        transport,
+        port,
+        host,
+        verbose,
+    };
+}
+async function main() {
+    const config = loadConfig();
+    try {
+        validateCredentials(config.credentials);
+    }
+    catch (err) {
+        console.error(`Error: ${err.message}`);
+        console.error("\nSee https://github.com/topcheer/appstore-connect-mcp#setup for help.");
+        process.exit(1);
+    }
+    // Verify the key works by generating a test token
+    try {
+        getToken(config.credentials);
+    }
+    catch (err) {
+        console.error(`Error: Failed to sign JWT — invalid private key. ${err.message}`);
+        process.exit(1);
+    }
+    if (config.verbose) {
+        console.error(`[appstore-connect-mcp] Starting in ${config.transport} mode`);
+    }
+    if (config.transport === "http") {
+        // HTTP mode: factory creates a fresh server per session
+        const createServer = () => createMcpServer({
+            credentials: config.credentials,
+            verbose: config.verbose,
+        });
+        await startHttp(createServer, config.host ?? "0.0.0.0", config.port ?? 3000);
+    }
+    else {
+        // Stdio mode: single server instance
+        const server = createMcpServer({
+            credentials: config.credentials,
+            verbose: config.verbose,
+        });
+        await startStdio(server);
+    }
+}
+main().catch((err) => {
+    console.error("Fatal error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,22 @@
+/**
+ * server.ts — MCP server core.
+ *
+ * Creates a Model Context Protocol server that exposes all App Store Connect
+ * API operations as MCP tools. Uses the low-level Server class for efficient
+ * handling of 1200+ dynamically-generated tools.
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import type { ASCCredentials } from "./types.js";
+export interface CreateServerOptions {
+    credentials: ASCCredentials;
+    verbose?: boolean;
+}
+/**
+ * Create and configure the MCP server.
+ *
+ * Registers:
+ *   - ListTools handler → returns all generated tools + 3 meta-tools
+ *   - CallTool handler  → dispatches to the API or meta-tool
+ */
+export declare function createMcpServer(opts: CreateServerOptions): Server;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAKnE,OAAO,KAAK,EAAE,cAAc,EAAW,MAAM,YAAY,CAAC;AAG1D,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,cAAc,CAAC;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,mBAAmB,GAAG,MAAM,CA+NjE"}

package/dist/server.js

@@ -0,0 +1,208 @@
+/**
+ * server.ts — MCP server core.
+ *
+ * Creates a Model Context Protocol server that exposes all App Store Connect
+ * API operations as MCP tools. Uses the low-level Server class for efficient
+ * handling of 1200+ dynamically-generated tools.
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { ListToolsRequestSchema, CallToolRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { loadTools, buildInputSchema, executeTool } from "./tools.js";
+/**
+ * Create and configure the MCP server.
+ *
+ * Registers:
+ *   - ListTools handler → returns all generated tools + 3 meta-tools
+ *   - CallTool handler  → dispatches to the API or meta-tool
+ */
+export function createMcpServer(opts) {
+    const { credentials, verbose } = opts;
+    const toolsData = loadTools();
+    // Build a lookup map for O(1) dispatch
+    const toolMap = new Map();
+    for (const t of toolsData.tools) {
+        toolMap.set(t.name, t);
+    }
+    const server = new Server({
+        name: "appstore-connect-mcp",
+        version: "1.0.0",
+    }, {
+        capabilities: {
+            tools: {},
+        },
+    });
+    // ── ListTools handler ──────────────────────────────────────────
+    server.setRequestHandler(ListToolsRequestSchema, async (request) => {
+        const cursor = request.params?.cursor;
+        const PAGE_SIZE = 100;
+        const startIndex = cursor ? parseInt(cursor, 10) || 0 : 0;
+        const allTools = toolsData.tools;
+        const page = allTools.slice(startIndex, startIndex + PAGE_SIZE);
+        const hasNext = startIndex + PAGE_SIZE < allTools.length;
+        const mcpTools = page.map((tool) => ({
+            name: tool.name,
+            description: `[${tool.category}] ${tool.summary} (${tool.method} ${tool.path})`,
+            inputSchema: buildInputSchema(tool),
+        }));
+        // On the first page, also add meta-tools
+        if (startIndex === 0) {
+            mcpTools.unshift({
+                name: "search_apis",
+                description: "Search App Store Connect API operations by keyword. Returns matching tool names, methods, and paths.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        query: {
+                            type: "string",
+                            description: "Search keyword (e.g. 'app', 'build', 'subscription', 'review')",
+                        },
+                        category: {
+                            type: "string",
+                            description: "Filter by category (e.g. 'Apps', 'Builds')",
+                        },
+                        method: {
+                            type: "string",
+                            enum: ["GET", "POST", "PATCH", "DELETE"],
+                            description: "Filter by HTTP method",
+                        },
+                    },
+                    required: ["query"],
+                },
+            }, {
+                name: "list_categories",
+                description: "List all API categories (resource groups) available in the App Store Connect API.",
+                inputSchema: {
+                    type: "object",
+                    properties: {},
+                },
+            }, {
+                name: "get_tool_details",
+                description: "Get full details of a specific API operation including all parameters and their descriptions.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        name: {
+                            type: "string",
+                            description: "The tool name (operationId), e.g. 'apps_getCollection'",
+                        },
+                    },
+                    required: ["name"],
+                },
+            });
+        }
+        return {
+            tools: mcpTools,
+            ...(hasNext ? { nextCursor: String(startIndex + PAGE_SIZE) } : {}),
+        };
+    });
+    // ── CallTool handler ───────────────────────────────────────────
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        const toolArgs = (args ?? {});
+        if (verbose) {
+            console.error(`[appstore-connect-mcp] tool call: ${name}`);
+        }
+        // ── Meta-tools ───────────────────────────────────────────────
+        if (name === "search_apis") {
+            const query = String(toolArgs.query || "").toLowerCase();
+            const category = toolArgs.category;
+            const method = toolArgs.method;
+            const matches = toolsData.tools.filter((t) => {
+                if (category && t.category !== category)
+                    return false;
+                if (method && t.method !== method)
+                    return false;
+                const haystack = `${t.name} ${t.summary} ${t.path} ${t.category}`.toLowerCase();
+                return haystack.includes(query);
+            });
+            const results = matches.slice(0, 50).map((t) => ({
+                name: t.name,
+                summary: t.summary,
+                method: t.method,
+                path: t.path,
+                category: t.category,
+            }));
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            query,
+                            totalMatches: matches.length,
+                            showing: results.length,
+                            results,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        if (name === "list_categories") {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            apiVersion: toolsData.apiVersion,
+                            totalTools: toolsData.stats.total,
+                            totalCategories: toolsData.categories.length,
+                            categories: toolsData.categories,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        if (name === "get_tool_details") {
+            const toolName = String(toolArgs.name);
+            const tool = toolMap.get(toolName);
+            if (!tool) {
+                return {
+                    content: [{ type: "text", text: `Tool not found: ${toolName}` }],
+                    isError: true,
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(tool, null, 2),
+                    },
+                ],
+            };
+        }
+        // ── API tools ────────────────────────────────────────────────
+        const tool = toolMap.get(name);
+        if (!tool) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Unknown tool: ${name}. Use search_apis to find available operations.`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        try {
+            const result = await executeTool(tool, toolArgs, credentials);
+            // Format response — ensure it's compact text for the LLM
+            const text = typeof result === "string" ? result : JSON.stringify(result, null, 2);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: text.length > 50000 ? text.slice(0, 50000) + "\n... (truncated)" : text,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                content: [{ type: "text", text: `API Error: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/tools.d.ts

@@ -0,0 +1,22 @@
+/**
+ * tools.ts — Tool registry: loads tools.json, builds MCP input schemas,
+ * and dispatches tool calls to the API client.
+ */
+import type { ToolDef, ToolsData, ASCCredentials } from "./types.js";
+/** Load the generated tools data from tools.json. */
+export declare function loadTools(): ToolsData;
+/**
+ * Build a JSON Schema input for an MCP tool from its definition.
+ *
+ * Path params become top-level required string properties.
+ * Query params become optional properties (arrays / strings / enums).
+ * POST/PATCH operations get a `_body` object property.
+ */
+export declare function buildInputSchema(tool: ToolDef): object;
+/**
+ * Execute a tool call: extract params, call the API, return the result.
+ *
+ * @returns the API response (already JSON-parsed).
+ */
+export declare function executeTool(tool: ToolDef, args: Record<string, unknown>, credentials: ASCCredentials): Promise<unknown>;
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAKrE,qDAAqD;AACrD,wBAAgB,SAAS,IAAI,SAAS,CAGrC;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CA4DtD;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,WAAW,EAAE,cAAc,GAC1B,OAAO,CAAC,OAAO,CAAC,CAmClB"}

package/dist/tools.js

@@ -0,0 +1,118 @@
+/**
+ * tools.ts — Tool registry: loads tools.json, builds MCP input schemas,
+ * and dispatches tool calls to the API client.
+ */
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+import { callApi } from "./client.js";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+/** Load the generated tools data from tools.json. */
+export function loadTools() {
+    const raw = readFileSync(join(__dirname, "tools.json"), "utf-8");
+    return JSON.parse(raw);
+}
+/**
+ * Build a JSON Schema input for an MCP tool from its definition.
+ *
+ * Path params become top-level required string properties.
+ * Query params become optional properties (arrays / strings / enums).
+ * POST/PATCH operations get a `_body` object property.
+ */
+export function buildInputSchema(tool) {
+    const properties = {};
+    const required = [];
+    // Path parameters
+    for (const p of tool.pathParams) {
+        properties[p.name] = {
+            type: "string",
+            description: p.description || `Path parameter: ${p.name}`,
+        };
+        if (p.required) {
+            required.push(p.name);
+        }
+    }
+    // Query parameters
+    for (const p of tool.queryParams) {
+        const schemaType = p.schema?.type;
+        if (schemaType === "array") {
+            const items = p.schema?.items;
+            properties[p.name] = {
+                type: "array",
+                items: {
+                    type: items?.type || "string",
+                    ...(items?.enum ? { enum: items.enum } : {}),
+                },
+                description: p.description || `Query parameter: ${p.name}`,
+            };
+        }
+        else if (p.schema?.enum) {
+            properties[p.name] = {
+                type: "string",
+                enum: p.schema.enum,
+                description: p.description || `Query parameter: ${p.name}`,
+            };
+        }
+        else {
+            properties[p.name] = {
+                type: schemaType || "string",
+                description: p.description || `Query parameter: ${p.name}`,
+            };
+        }
+        if (p.required) {
+            required.push(p.name);
+        }
+    }
+    // Request body for POST/PATCH
+    if (tool.hasBody) {
+        properties["_body"] = {
+            type: "object",
+            description: "JSON:API request body. Follow the App Store Connect API JSON:API format: { data: { type, attributes, relationships } }.",
+        };
+        required.push("_body");
+    }
+    return {
+        type: "object",
+        properties,
+        ...(required.length > 0 ? { required } : {}),
+    };
+}
+/**
+ * Execute a tool call: extract params, call the API, return the result.
+ *
+ * @returns the API response (already JSON-parsed).
+ */
+export async function executeTool(tool, args, credentials) {
+    // Separate path params, query params, and body
+    const pathParams = {};
+    const queryParams = {};
+    let body = undefined;
+    for (const p of tool.pathParams) {
+        if (p.name in args) {
+            pathParams[p.name] = String(args[p.name]);
+        }
+    }
+    for (const p of tool.queryParams) {
+        if (p.name in args && args[p.name] !== undefined) {
+            const val = args[p.name];
+            if (Array.isArray(val)) {
+                queryParams[p.name] = val.map(String);
+            }
+            else {
+                queryParams[p.name] = String(val);
+            }
+        }
+    }
+    if (tool.hasBody && "_body" in args) {
+        body = args["_body"];
+    }
+    return callApi({
+        method: tool.method,
+        path: tool.path,
+        pathParams,
+        queryParams,
+        body,
+        credentials,
+    });
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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