appstore-mcp 1.0.0 → 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Khoa Pham
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,6 +1,6 @@
 # App Store MCP
 
-A Model Context Protocol (MCP) server for interacting with Apple's App Store iTunes API. This tool enables querying app information, searching the App Store, discovering trending apps, and retrieving app metadata through a standardized interface.
+A Model Context Protocol (MCP) server for interacting with Apple's App Store. This tool enables querying app information, searching the App Store, discovering trending apps, and retrieving app metadata through a standardized interface.
 
 ## Features
 
@@ -29,10 +29,6 @@ A Model Context Protocol (MCP) server for interacting with Apple's App Store iTu
 - Latest version release date
 - Current version number
 
-## Prerequisites
-
-- Node.js 18.0.0 or higher
-
 ## Installation
 
 Add to your MCP config:

package/dist/index.js

@@ -7,7 +7,7 @@ const tools_1 = require("./mcp/tools");
 const resources_1 = require("./mcp/resources");
 const server = new mcp_js_1.McpServer({
     name: 'appstore-mcp',
-    version: '1.0.0',
+    version: '1.0.1',
 });
 (0, tools_1.registerAllTools)(server);
 (0, resources_1.registerAllResources)(server);

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "appstore-mcp",
-    "version": "1.0.0",
+    "version": "1.0.1",
     "type": "module",
     "description": "MCP server for interacting with App Store iTunes API",
     "main": "dist/index.js",
@@ -17,16 +17,35 @@
         "lint": "eslint src/**/*.ts",
         "lint:fix": "eslint src/**/*.ts --fix",
         "format": "prettier --write \"src/**/*.ts\"",
-        "format:check": "prettier --check \"src/**/*.ts\""
+        "format:check": "prettier --check \"src/**/*.ts\"",
+        "prepublishOnly": "pnpm run build"
     },
     "keywords": [
         "mcp",
+        "model-context-protocol",
         "appstore",
         "itunes",
-        "api"
+        "apple",
+        "ios",
+        "api",
+        "claude",
+        "ai"
     ],
-    "author": "",
+    "author": "Khoa Pham",
     "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/onmyway133/appstore-mcp.git"
+    },
+    "homepage": "https://github.com/onmyway133/appstore-mcp#readme",
+    "bugs": {
+        "url": "https://github.com/onmyway133/appstore-mcp/issues"
+    },
+    "files": [
+        "dist",
+        "README.md",
+        "LICENSE"
+    ],
     "dependencies": {
         "@modelcontextprotocol/sdk": "^1.25.1",
         "axios": "^1.7.9",

package/.claude/CLAUDE.md

@@ -1,29 +0,0 @@
-You are senior Nodejs React developer. You write code in well structured, easy to read manner, with self explanatory code.
-
-Help me implmenet mcp called appstre-mcp that helps to intereact with App Store itunes api
-
-Use typescript  to implement, with modern nodejs version. Using 4 spaces. Use kebab-case for file naming
-
-Code style and structure whodul be based on  /Users/khoa/XcodeProject1/string-catalog-mcp
-
-The feature code should be based on /Users/khoa/XcodeProject1/indiegoodies/src/features/tools/appstore-search, it uses app store itunes and rss api
-
-Copy concept and use case, refactor to make code differnt
-
-so we will have these tools, each tool will be in a folder kinside tools
-
-src
-    mcp
-        tools
-
-        resources
-
-Use pnpm for packcage management, use lates version of mcp sdk typescript, axios and zod
-
-Wtih this mcp, yser can ask questiosn like
-
-- list grossibga pps
-- get app detail
-- when is this app (name | id) release
-- download screenshots for this app
-- show trending apps in a categpry ina country. if n country then default to US

package/.claude/settings.local.json

@@ -1,24 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(npm install:*)",
-      "Bash(pnpm install)",
-      "Bash(pnpm run build:*)",
-      "Bash(cat:*)",
-      "Bash(timeout 3 node:*)",
-      "Bash(pnpm add:*)",
-      "Bash(pnpm run typecheck:*)",
-      "Bash(pnpm run lint)",
-      "Bash(mkdir:*)",
-      "Bash(tree:*)",
-      "Bash(xargs basename:*)",
-      "Bash(ls:*)",
-      "Bash(xargs:*)",
-      "Bash(lsof:*)",
-      "Bash(git tag:*)",
-      "Bash(git push:*)",
-      "Bash(timeout 3 pnpm run dev:*)",
-      "Bash(gtimeout 3 pnpm run dev:*)"
-    ]
-  }
-}

package/.prettierrc

@@ -1,7 +0,0 @@
-{
-    "semi": true,
-    "singleQuote": true,
-    "tabWidth": 4,
-    "trailingComma": "es5",
-    "printWidth": 100
-}

package/eslint.config.js

@@ -1,9 +0,0 @@
-import eslint from '@eslint/js';
-import tseslint from 'typescript-eslint';
-
-export default tseslint.config(eslint.configs.recommended, ...tseslint.configs.recommended, {
-    rules: {
-        '@typescript-eslint/no-unused-vars': 'warn',
-        '@typescript-eslint/no-explicit-any': 'warn',
-    },
-});

package/src/index.ts

@@ -1,24 +0,0 @@
-#!/usr/bin/env node
-
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { registerAllTools } from './mcp/tools';
-import { registerAllResources } from './mcp/resources';
-
-const server = new McpServer({
-    name: 'appstore-mcp',
-    version: '1.0.0',
-});
-
-registerAllTools(server);
-registerAllResources(server);
-
-async function main() {
-    const transport = new StdioServerTransport();
-    await server.connect(transport);
-}
-
-main().catch((error) => {
-    console.error('Failed to start server:', error);
-    process.exit(1);
-});

package/src/mcp/resources/countries.ts

@@ -1,234 +0,0 @@
-import { Country } from '../../types';
-
-export const COUNTRIES: Country[] = [
-    { code: 'AF', name: 'Afghanistan' },
-    { code: 'AL', name: 'Albania' },
-    { code: 'DZ', name: 'Algeria' },
-    { code: 'AS', name: 'American Samoa' },
-    { code: 'AD', name: 'Andorra' },
-    { code: 'AO', name: 'Angola' },
-    { code: 'AI', name: 'Anguilla' },
-    { code: 'AR', name: 'Argentina' },
-    { code: 'AM', name: 'Armenia' },
-    { code: 'AW', name: 'Aruba' },
-    { code: 'AU', name: 'Australia' },
-    { code: 'AT', name: 'Austria' },
-    { code: 'AZ', name: 'Azerbaijan' },
-    { code: 'BS', name: 'Bahamas' },
-    { code: 'BH', name: 'Bahrain' },
-    { code: 'BD', name: 'Bangladesh' },
-    { code: 'BB', name: 'Barbados' },
-    { code: 'BY', name: 'Belarus' },
-    { code: 'BE', name: 'Belgium' },
-    { code: 'BZ', name: 'Belize' },
-    { code: 'BJ', name: 'Benin' },
-    { code: 'BM', name: 'Bermuda' },
-    { code: 'BT', name: 'Bhutan' },
-    { code: 'BO', name: 'Bolivia' },
-    { code: 'BA', name: 'Bosnia and Herzegovina' },
-    { code: 'BW', name: 'Botswana' },
-    { code: 'BR', name: 'Brazil' },
-    { code: 'VG', name: 'British Virgin Islands' },
-    { code: 'BN', name: 'Brunei' },
-    { code: 'BG', name: 'Bulgaria' },
-    { code: 'BF', name: 'Burkina Faso' },
-    { code: 'BI', name: 'Burundi' },
-    { code: 'KH', name: 'Cambodia' },
-    { code: 'CM', name: 'Cameroon' },
-    { code: 'CA', name: 'Canada' },
-    { code: 'CV', name: 'Cape Verde' },
-    { code: 'KY', name: 'Cayman Islands' },
-    { code: 'CF', name: 'Central African Republic' },
-    { code: 'TD', name: 'Chad' },
-    { code: 'CL', name: 'Chile' },
-    { code: 'CN', name: 'China' },
-    { code: 'CO', name: 'Colombia' },
-    { code: 'KM', name: 'Comoros' },
-    { code: 'CK', name: 'Cook Islands' },
-    { code: 'CR', name: 'Costa Rica' },
-    { code: 'HR', name: 'Croatia' },
-    { code: 'CU', name: 'Cuba' },
-    { code: 'CW', name: 'Curacao' },
-    { code: 'CY', name: 'Cyprus' },
-    { code: 'CZ', name: 'Czech Republic' },
-    { code: 'CD', name: 'Democratic Republic of the Congo' },
-    { code: 'DK', name: 'Denmark' },
-    { code: 'DJ', name: 'Djibouti' },
-    { code: 'DM', name: 'Dominica' },
-    { code: 'DO', name: 'Dominican Republic' },
-    { code: 'TL', name: 'East Timor' },
-    { code: 'EC', name: 'Ecuador' },
-    { code: 'EG', name: 'Egypt' },
-    { code: 'SV', name: 'El Salvador' },
-    { code: 'ER', name: 'Eritrea' },
-    { code: 'EE', name: 'Estonia' },
-    { code: 'ET', name: 'Ethiopia' },
-    { code: 'FO', name: 'Faroe Islands' },
-    { code: 'FJ', name: 'Fiji' },
-    { code: 'FI', name: 'Finland' },
-    { code: 'FR', name: 'France' },
-    { code: 'PF', name: 'French Polynesia' },
-    { code: 'GA', name: 'Gabon' },
-    { code: 'GM', name: 'Gambia' },
-    { code: 'GE', name: 'Georgia' },
-    { code: 'DE', name: 'Germany' },
-    { code: 'GH', name: 'Ghana' },
-    { code: 'GR', name: 'Greece' },
-    { code: 'GL', name: 'Greenland' },
-    { code: 'GD', name: 'Grenada' },
-    { code: 'GU', name: 'Guam' },
-    { code: 'GT', name: 'Guatemala' },
-    { code: 'GG', name: 'Guernsey' },
-    { code: 'GN', name: 'Guinea' },
-    { code: 'GW', name: 'Guinea-Bissau' },
-    { code: 'GY', name: 'Guyana' },
-    { code: 'HT', name: 'Haiti' },
-    { code: 'HN', name: 'Honduras' },
-    { code: 'HK', name: 'Hong Kong' },
-    { code: 'HU', name: 'Hungary' },
-    { code: 'IS', name: 'Iceland' },
-    { code: 'IN', name: 'India' },
-    { code: 'ID', name: 'Indonesia' },
-    { code: 'IR', name: 'Iran' },
-    { code: 'IQ', name: 'Iraq' },
-    { code: 'IE', name: 'Ireland' },
-    { code: 'IM', name: 'Isle of Man' },
-    { code: 'IL', name: 'Israel' },
-    { code: 'IT', name: 'Italy' },
-    { code: 'CI', name: 'Ivory Coast' },
-    { code: 'JM', name: 'Jamaica' },
-    { code: 'JP', name: 'Japan' },
-    { code: 'JE', name: 'Jersey' },
-    { code: 'JO', name: 'Jordan' },
-    { code: 'KZ', name: 'Kazakhstan' },
-    { code: 'KE', name: 'Kenya' },
-    { code: 'KI', name: 'Kiribati' },
-    { code: 'XK', name: 'Kosovo' },
-    { code: 'KW', name: 'Kuwait' },
-    { code: 'KG', name: 'Kyrgyzstan' },
-    { code: 'LA', name: 'Laos' },
-    { code: 'LV', name: 'Latvia' },
-    { code: 'LB', name: 'Lebanon' },
-    { code: 'LS', name: 'Lesotho' },
-    { code: 'LR', name: 'Liberia' },
-    { code: 'LY', name: 'Libya' },
-    { code: 'LI', name: 'Liechtenstein' },
-    { code: 'LT', name: 'Lithuania' },
-    { code: 'LU', name: 'Luxembourg' },
-    { code: 'MO', name: 'Macau' },
-    { code: 'MK', name: 'Macedonia' },
-    { code: 'MG', name: 'Madagascar' },
-    { code: 'MW', name: 'Malawi' },
-    { code: 'MY', name: 'Malaysia' },
-    { code: 'MV', name: 'Maldives' },
-    { code: 'ML', name: 'Mali' },
-    { code: 'MT', name: 'Malta' },
-    { code: 'MH', name: 'Marshall Islands' },
-    { code: 'MR', name: 'Mauritania' },
-    { code: 'MU', name: 'Mauritius' },
-    { code: 'YT', name: 'Mayotte' },
-    { code: 'MX', name: 'Mexico' },
-    { code: 'FM', name: 'Micronesia' },
-    { code: 'MD', name: 'Moldova' },
-    { code: 'MC', name: 'Monaco' },
-    { code: 'MN', name: 'Mongolia' },
-    { code: 'ME', name: 'Montenegro' },
-    { code: 'MA', name: 'Morocco' },
-    { code: 'MZ', name: 'Mozambique' },
-    { code: 'MM', name: 'Myanmar' },
-    { code: 'NA', name: 'Namibia' },
-    { code: 'NP', name: 'Nepal' },
-    { code: 'NL', name: 'Netherlands' },
-    { code: 'AN', name: 'Netherlands Antilles' },
-    { code: 'NC', name: 'New Caledonia' },
-    { code: 'NZ', name: 'New Zealand' },
-    { code: 'NI', name: 'Nicaragua' },
-    { code: 'NE', name: 'Niger' },
-    { code: 'NG', name: 'Nigeria' },
-    { code: 'KP', name: 'North Korea' },
-    { code: 'MP', name: 'Northern Mariana Islands' },
-    { code: 'NO', name: 'Norway' },
-    { code: 'OM', name: 'Oman' },
-    { code: 'PK', name: 'Pakistan' },
-    { code: 'PS', name: 'Palestine' },
-    { code: 'PA', name: 'Panama' },
-    { code: 'PG', name: 'Papua New Guinea' },
-    { code: 'PY', name: 'Paraguay' },
-    { code: 'PE', name: 'Peru' },
-    { code: 'PH', name: 'Philippines' },
-    { code: 'PL', name: 'Poland' },
-    { code: 'PT', name: 'Portugal' },
-    { code: 'PR', name: 'Puerto Rico' },
-    { code: 'QA', name: 'Qatar' },
-    { code: 'CG', name: 'Republic of the Congo' },
-    { code: 'RE', name: 'Reunion' },
-    { code: 'RO', name: 'Romania' },
-    { code: 'RU', name: 'Russia' },
-    { code: 'RW', name: 'Rwanda' },
-    { code: 'KN', name: 'Saint Kitts and Nevis' },
-    { code: 'LC', name: 'Saint Lucia' },
-    { code: 'MF', name: 'Saint Martin' },
-    { code: 'PM', name: 'Saint Pierre and Miquelon' },
-    { code: 'VC', name: 'Saint Vincent and the Grenadines' },
-    { code: 'WS', name: 'Samoa' },
-    { code: 'SM', name: 'San Marino' },
-    { code: 'ST', name: 'Sao Tome and Principe' },
-    { code: 'SA', name: 'Saudi Arabia' },
-    { code: 'SN', name: 'Senegal' },
-    { code: 'RS', name: 'Serbia' },
-    { code: 'SC', name: 'Seychelles' },
-    { code: 'SL', name: 'Sierra Leone' },
-    { code: 'SG', name: 'Singapore' },
-    { code: 'SX', name: 'Sint Maarten' },
-    { code: 'SK', name: 'Slovakia' },
-    { code: 'SI', name: 'Slovenia' },
-    { code: 'SB', name: 'Solomon Islands' },
-    { code: 'SO', name: 'Somalia' },
-    { code: 'ZA', name: 'South Africa' },
-    { code: 'KR', name: 'South Korea' },
-    { code: 'SS', name: 'South Sudan' },
-    { code: 'ES', name: 'Spain' },
-    { code: 'LK', name: 'Sri Lanka' },
-    { code: 'SD', name: 'Sudan' },
-    { code: 'SR', name: 'Suriname' },
-    { code: 'SZ', name: 'Swaziland' },
-    { code: 'SE', name: 'Sweden' },
-    { code: 'CH', name: 'Switzerland' },
-    { code: 'SY', name: 'Syria' },
-    { code: 'TW', name: 'Taiwan' },
-    { code: 'TJ', name: 'Tajikistan' },
-    { code: 'TZ', name: 'Tanzania' },
-    { code: 'TH', name: 'Thailand' },
-    { code: 'TG', name: 'Togo' },
-    { code: 'TO', name: 'Tonga' },
-    { code: 'TT', name: 'Trinidad and Tobago' },
-    { code: 'TN', name: 'Tunisia' },
-    { code: 'TR', name: 'Turkey' },
-    { code: 'TM', name: 'Turkmenistan' },
-    { code: 'TC', name: 'Turks and Caicos Islands' },
-    { code: 'TV', name: 'Tuvalu' },
-    { code: 'VI', name: 'U.S. Virgin Islands' },
-    { code: 'UG', name: 'Uganda' },
-    { code: 'UA', name: 'Ukraine' },
-    { code: 'AE', name: 'United Arab Emirates' },
-    { code: 'GB', name: 'United Kingdom' },
-    { code: 'US', name: 'United States' },
-    { code: 'UY', name: 'Uruguay' },
-    { code: 'UZ', name: 'Uzbekistan' },
-    { code: 'VU', name: 'Vanuatu' },
-    { code: 'VE', name: 'Venezuela' },
-    { code: 'VN', name: 'Vietnam' },
-    { code: 'EH', name: 'Western Sahara' },
-    { code: 'YE', name: 'Yemen' },
-    { code: 'ZM', name: 'Zambia' },
-    { code: 'ZW', name: 'Zimbabwe' },
-];
-
-export function findCountryByCode(code: string): Country | undefined {
-    return COUNTRIES.find((country) => country.code.toUpperCase() === code.toUpperCase());
-}
-
-export function findCountryByName(name: string): Country | undefined {
-    const lowerName = name.toLowerCase();
-    return COUNTRIES.find((country) => country.name.toLowerCase().includes(lowerName));
-}

package/src/mcp/resources/index.ts

@@ -1,117 +0,0 @@
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { COUNTRIES } from './countries';
-import { APP_STORE_CATEGORIES, PLATFORMS, PRICING_TYPES } from '../../types';
-
-export function registerAllResources(server: McpServer) {
-    server.registerResource(
-        'countries',
-        'appstore://countries',
-        {
-            description: 'List of all available App Store country codes',
-            mimeType: 'application/json',
-        },
-        async (uri) => ({
-            contents: [
-                {
-                    uri: uri.href,
-                    mimeType: 'application/json',
-                    text: JSON.stringify(
-                        {
-                            count: COUNTRIES.length,
-                            countries: COUNTRIES.map((country) => ({
-                                code: country.code,
-                                name: country.name,
-                            })),
-                        },
-                        null,
-                        2
-                    ),
-                },
-            ],
-        })
-    );
-
-    server.registerResource(
-        'categories',
-        'appstore://categories',
-        {
-            description: 'List of all App Store categories with their IDs',
-            mimeType: 'application/json',
-        },
-        async (uri) => ({
-            contents: [
-                {
-                    uri: uri.href,
-                    mimeType: 'application/json',
-                    text: JSON.stringify(
-                        {
-                            categories: APP_STORE_CATEGORIES.map((category) => ({
-                                id: category.id,
-                                name: category.name,
-                                emoji: category.emoji,
-                            })),
-                        },
-                        null,
-                        2
-                    ),
-                },
-            ],
-        })
-    );
-
-    server.registerResource(
-        'platforms',
-        'appstore://platforms',
-        {
-            description: 'List of supported App Store platforms',
-            mimeType: 'application/json',
-        },
-        async (uri) => ({
-            contents: [
-                {
-                    uri: uri.href,
-                    mimeType: 'application/json',
-                    text: JSON.stringify(
-                        {
-                            platforms: PLATFORMS.map((platform) => ({
-                                value: platform.value,
-                                label: platform.label,
-                                emoji: platform.emoji,
-                            })),
-                        },
-                        null,
-                        2
-                    ),
-                },
-            ],
-        })
-    );
-
-    server.registerResource(
-        'pricing-types',
-        'appstore://pricing-types',
-        {
-            description: 'List of App Store pricing types (free, paid, grossing)',
-            mimeType: 'application/json',
-        },
-        async (uri) => ({
-            contents: [
-                {
-                    uri: uri.href,
-                    mimeType: 'application/json',
-                    text: JSON.stringify(
-                        {
-                            pricingTypes: PRICING_TYPES.map((pricing) => ({
-                                value: pricing.value,
-                                label: pricing.label,
-                                emoji: pricing.emoji,
-                            })),
-                        },
-                        null,
-                        2
-                    ),
-                },
-            ],
-        })
-    );
-}

package/src/mcp/tools/get-app-info.ts

@@ -1,183 +0,0 @@
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { z } from 'zod';
-import { AppStoreService } from '../../services/app-store-service';
-
-type InfoType = 'basic' | 'full' | 'release' | 'screenshots';
-
-function formatDate(dateString?: string): string | null {
-    if (!dateString) return null;
-    const date = new Date(dateString);
-    return date.toLocaleDateString('en-US', {
-        year: 'numeric',
-        month: 'long',
-        day: 'numeric',
-    });
-}
-
-export function registerGetAppInfo(server: McpServer) {
-    server.registerTool(
-        'get_app_info',
-        {
-            description:
-                'Get information about a specific app by its App Store ID. Use the "include" parameter to specify what data to return.',
-            inputSchema: {
-                appId: z
-                    .string()
-                    .describe('The App Store ID of the app (numeric ID from the App Store URL)'),
-                country: z
-                    .string()
-                    .optional()
-                    .describe('Country code for the App Store (e.g., US, GB, JP). Defaults to US'),
-                include: z
-                    .string()
-                    .optional()
-                    .describe(
-                        'What info to include: "basic" (name, artist, icon, price, rating), "full" (all details including description), "release" (release dates and version), "screenshots" (screenshot URLs). Defaults to "basic"'
-                    ),
-            },
-        },
-        async ({ appId, country, include }) => {
-            const countryCode = country || 'US';
-            const infoType = (include || 'basic') as InfoType;
-
-            try {
-                const app = await AppStoreService.getAppDetails(appId, countryCode);
-
-                if (!app) {
-                    return {
-                        content: [
-                            {
-                                type: 'text' as const,
-                                text: JSON.stringify(
-                                    {
-                                        success: false,
-                                        error: `App with ID ${appId} not found`,
-                                    },
-                                    null,
-                                    2
-                                ),
-                            },
-                        ],
-                    };
-                }
-
-                let result: Record<string, unknown> = {
-                    success: true,
-                    appId: app.id,
-                    country: countryCode,
-                    include: infoType,
-                };
-
-                switch (infoType) {
-                    case 'basic':
-                        result.app = {
-                            id: app.id,
-                            name: app.name,
-                            artistName: app.artistName,
-                            url: app.url,
-                            iconUrl: app.iconUrl,
-                            formattedPrice: app.formattedPrice || 'Free',
-                            rating: app.averageUserRating?.toFixed(1) || 'N/A',
-                            ratingCount: app.userRatingCount || 0,
-                            primaryGenre: app.primaryGenreName,
-                        };
-                        break;
-
-                    case 'full':
-                        result.app = {
-                            id: app.id,
-                            name: app.name,
-                            artistName: app.artistName,
-                            bundleId: app.bundleId,
-                            url: app.url,
-                            iconUrl: app.iconUrl,
-                            description: app.description,
-                            version: app.version,
-                            price: app.price,
-                            formattedPrice: app.formattedPrice || 'Free',
-                            primaryGenre: app.primaryGenreName,
-                            genres: app.genres,
-                            rating: app.averageUserRating?.toFixed(1) || 'N/A',
-                            ratingCount: app.userRatingCount || 0,
-                            releaseDate: app.releaseDate,
-                            releaseDateFormatted: formatDate(app.releaseDate),
-                            currentVersionReleaseDate: app.currentVersionReleaseDate,
-                            currentVersionReleaseDateFormatted: formatDate(
-                                app.currentVersionReleaseDate
-                            ),
-                            minimumOsVersion: app.minimumOsVersion,
-                            fileSizeBytes: app.fileSizeBytes,
-                            contentAdvisoryRating: app.contentAdvisoryRating,
-                            screenshotCount: app.screenshotUrls?.length || 0,
-                            ipadScreenshotCount: app.ipadScreenshotUrls?.length || 0,
-                        };
-                        break;
-
-                    case 'release':
-                        result.release = {
-                            currentVersion: app.version,
-                            originalReleaseDate: app.releaseDate,
-                            originalReleaseDateFormatted: formatDate(app.releaseDate),
-                            currentVersionReleaseDate: app.currentVersionReleaseDate,
-                            currentVersionReleaseDateFormatted: formatDate(
-                                app.currentVersionReleaseDate
-                            ),
-                        };
-                        break;
-
-                    case 'screenshots':
-                        result.screenshots = {
-                            iphone: {
-                                count: app.screenshotUrls?.length || 0,
-                                urls: app.screenshotUrls || [],
-                            },
-                            ipad: {
-                                count: app.ipadScreenshotUrls?.length || 0,
-                                urls: app.ipadScreenshotUrls || [],
-                            },
-                        };
-                        break;
-
-                    default:
-                        result.app = {
-                            id: app.id,
-                            name: app.name,
-                            artistName: app.artistName,
-                            url: app.url,
-                            iconUrl: app.iconUrl,
-                            formattedPrice: app.formattedPrice || 'Free',
-                            rating: app.averageUserRating?.toFixed(1) || 'N/A',
-                            ratingCount: app.userRatingCount || 0,
-                            primaryGenre: app.primaryGenreName,
-                        };
-                }
-
-                return {
-                    content: [
-                        {
-                            type: 'text' as const,
-                            text: JSON.stringify(result, null, 2),
-                        },
-                    ],
-                };
-            } catch (error) {
-                const errorMessage = error instanceof Error ? error.message : 'Unknown error';
-                return {
-                    content: [
-                        {
-                            type: 'text' as const,
-                            text: JSON.stringify(
-                                {
-                                    success: false,
-                                    error: errorMessage,
-                                },
-                                null,
-                                2
-                            ),
-                        },
-                    ],
-                };
-            }
-        }
-    );
-}

package/src/mcp/tools/get-trending-apps.ts

@@ -1,108 +0,0 @@
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { z } from 'zod';
-import { AppStoreService } from '../../services/app-store-service';
-import { APP_STORE_CATEGORIES, Platform, PricingType } from '../../types';
-
-export function registerGetTrendingApps(server: McpServer) {
-    server.registerTool(
-        'get_trending_apps',
-        {
-            description: 'Get top/trending apps from the App Store by category, platform, and pricing type',
-            inputSchema: {
-                platform: z
-                    .string()
-                    .optional()
-                    .describe('Platform to get apps for: iphone, ipad, mac, or tv. Defaults to iphone'),
-                pricingType: z
-                    .string()
-                    .optional()
-                    .describe(
-                        'Pricing type: free (top free apps), paid (top paid apps), or grossing (top grossing apps). Defaults to free'
-                    ),
-                country: z
-                    .string()
-                    .optional()
-                    .describe('Country code for the App Store (e.g., US, GB, JP). Defaults to US'),
-                categoryId: z
-                    .string()
-                    .optional()
-                    .describe(
-                        'Optional category ID to filter by (e.g., 6014 for Games, 6007 for Productivity)'
-                    ),
-                limit: z
-                    .number()
-                    .optional()
-                    .describe('Maximum number of results to return (1-100). Defaults to 25'),
-            },
-        },
-        async ({ platform, pricingType, country, categoryId, limit }) => {
-            const platformValue = (platform || 'iphone') as Platform;
-            const pricingValue = (pricingType || 'free') as PricingType;
-            const countryCode = country || 'US';
-            const resultLimit = limit || 25;
-
-            try {
-                const apps = await AppStoreService.getTrendingApps(
-                    platformValue,
-                    pricingValue,
-                    countryCode,
-                    categoryId,
-                    resultLimit
-                );
-
-                const categoryInfo = categoryId
-                    ? APP_STORE_CATEGORIES.find((c) => c.id === categoryId)
-                    : null;
-
-                const result = {
-                    success: true,
-                    count: apps.length,
-                    filters: {
-                        platform: platformValue,
-                        pricingType: pricingValue,
-                        country: countryCode,
-                        category: categoryInfo
-                            ? { id: categoryInfo.id, name: categoryInfo.name }
-                            : 'All Categories',
-                    },
-                    apps: apps.map((app, index) => ({
-                        rank: index + 1,
-                        id: app.id,
-                        name: app.name,
-                        artistName: app.artistName,
-                        url: app.url,
-                        iconUrl: app.iconUrl,
-                        price: app.formattedPrice || 'Free',
-                        primaryGenre: app.primaryGenreName,
-                    })),
-                };
-
-                return {
-                    content: [
-                        {
-                            type: 'text' as const,
-                            text: JSON.stringify(result, null, 2),
-                        },
-                    ],
-                };
-            } catch (error) {
-                const errorMessage = error instanceof Error ? error.message : 'Unknown error';
-                return {
-                    content: [
-                        {
-                            type: 'text' as const,
-                            text: JSON.stringify(
-                                {
-                                    success: false,
-                                    error: errorMessage,
-                                },
-                                null,
-                                2
-                            ),
-                        },
-                    ],
-                };
-            }
-        }
-    );
-}

package/src/mcp/tools/index.ts

@@ -1,10 +0,0 @@
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { registerSearchApps } from './search-apps';
-import { registerGetAppInfo } from './get-app-info';
-import { registerGetTrendingApps } from './get-trending-apps';
-
-export function registerAllTools(server: McpServer) {
-    registerSearchApps(server);
-    registerGetAppInfo(server);
-    registerGetTrendingApps(server);
-}

package/src/mcp/tools/search-apps.ts

@@ -1,74 +0,0 @@
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { z } from 'zod';
-import { AppStoreService } from '../../services/app-store-service';
-
-export function registerSearchApps(server: McpServer) {
-    server.registerTool(
-        'search_apps',
-        {
-            description: 'Search for apps on the App Store by name or keyword',
-            inputSchema: {
-                query: z.string().describe('The search term to find apps'),
-                country: z
-                    .string()
-                    .optional()
-                    .describe('Country code for the App Store (e.g., US, GB, JP). Defaults to US'),
-                limit: z
-                    .number()
-                    .optional()
-                    .describe('Maximum number of results to return (1-200). Defaults to 25'),
-            },
-        },
-        async ({ query, country, limit }) => {
-            const countryCode = country || 'US';
-            const resultLimit = limit || 25;
-            try {
-                const apps = await AppStoreService.searchApps(query, countryCode, resultLimit);
-
-                const result = {
-                    success: true,
-                    count: apps.length,
-                    country: countryCode,
-                    query: query,
-                    apps: apps.map((app) => ({
-                        id: app.id,
-                        name: app.name,
-                        artistName: app.artistName,
-                        url: app.url,
-                        iconUrl: app.iconUrl,
-                        price: app.formattedPrice || 'Free',
-                        rating: app.averageUserRating?.toFixed(1) || 'N/A',
-                        ratingCount: app.userRatingCount || 0,
-                        primaryGenre: app.primaryGenreName,
-                    })),
-                };
-
-                return {
-                    content: [
-                        {
-                            type: 'text' as const,
-                            text: JSON.stringify(result, null, 2),
-                        },
-                    ],
-                };
-            } catch (error) {
-                const errorMessage = error instanceof Error ? error.message : 'Unknown error';
-                return {
-                    content: [
-                        {
-                            type: 'text' as const,
-                            text: JSON.stringify(
-                                {
-                                    success: false,
-                                    error: errorMessage,
-                                },
-                                null,
-                                2
-                            ),
-                        },
-                    ],
-                };
-            }
-        }
-    );
-}

package/src/services/app-store-service.ts

@@ -1,236 +0,0 @@
-import axios from 'axios';
-import { App, Platform, PricingType } from '../types';
-
-const ITUNES_SEARCH_URL = 'https://itunes.apple.com/search';
-const ITUNES_LOOKUP_URL = 'https://itunes.apple.com/lookup';
-const ITUNES_RSS_BASE = 'https://itunes.apple.com';
-
-interface SearchResponse {
-    resultCount: number;
-    results: ItunesSearchResult[];
-}
-
-interface ItunesSearchResult {
-    trackId: number;
-    trackName: string;
-    trackViewUrl: string;
-    artworkUrl100: string;
-    artistName: string;
-    averageUserRating?: number;
-    userRatingCount?: number;
-    releaseDate?: string;
-    currentVersionReleaseDate?: string;
-    description?: string;
-    version?: string;
-    price?: number;
-    formattedPrice?: string;
-    primaryGenreName?: string;
-    genres?: string[];
-    screenshotUrls?: string[];
-    ipadScreenshotUrls?: string[];
-    bundleId?: string;
-    minimumOsVersion?: string;
-    fileSizeBytes?: string;
-    contentAdvisoryRating?: string;
-}
-
-interface RssEntry {
-    'im:name': { label: string };
-    'im:image': { label: string }[];
-    id: {
-        label: string;
-        attributes: { 'im:id': string };
-    };
-    'im:artist': { label: string };
-    'im:releaseDate'?: { label: string };
-    summary?: { label: string };
-    'im:price'?: { label: string };
-    category?: {
-        attributes: { label: string };
-    };
-}
-
-interface RssResponse {
-    feed: {
-        entry: RssEntry[];
-    };
-}
-
-export class AppStoreService {
-    private static getFeedName(platform: Platform, pricingType: PricingType): string {
-        const feedMap: Record<Platform, Record<PricingType, string>> = {
-            iphone: {
-                free: 'topfreeapplications',
-                paid: 'toppaidapplications',
-                grossing: 'topgrossingapplications',
-            },
-            ipad: {
-                free: 'topfreeipadapplications',
-                paid: 'toppaidipadapplications',
-                grossing: 'topgrossingipadapplications',
-            },
-            mac: {
-                free: 'topfreemacapps',
-                paid: 'toppaidmacapps',
-                grossing: 'topgrossingmacapps',
-            },
-            tv: {
-                free: 'topfreeappletvapps',
-                paid: 'toppaidappletvapps',
-                grossing: 'topgrossingappletvapps',
-            },
-        };
-
-        return feedMap[platform][pricingType];
-    }
-
-    private static buildRssUrl(
-        countryCode: string,
-        feedName: string,
-        limit: number,
-        categoryId?: string
-    ): string {
-        const genrePart = categoryId ? `/genre=${categoryId}` : '';
-        return `${ITUNES_RSS_BASE}/${countryCode}/rss/${feedName}/limit=${limit}${genrePart}/json`;
-    }
-
-    private static parseSearchResult(item: ItunesSearchResult): App {
-        return {
-            id: String(item.trackId),
-            name: item.trackName,
-            url: item.trackViewUrl,
-            iconUrl: item.artworkUrl100,
-            artistName: item.artistName,
-            averageUserRating: item.averageUserRating,
-            userRatingCount: item.userRatingCount,
-            releaseDate: item.releaseDate,
-            currentVersionReleaseDate: item.currentVersionReleaseDate,
-            description: item.description,
-            version: item.version,
-            price: item.price,
-            formattedPrice: item.formattedPrice,
-            primaryGenreName: item.primaryGenreName,
-            genres: item.genres,
-            screenshotUrls: item.screenshotUrls,
-            ipadScreenshotUrls: item.ipadScreenshotUrls,
-            bundleId: item.bundleId,
-            minimumOsVersion: item.minimumOsVersion,
-            fileSizeBytes: item.fileSizeBytes,
-            contentAdvisoryRating: item.contentAdvisoryRating,
-        };
-    }
-
-    private static parseRssEntry(entry: RssEntry): App {
-        const images = entry['im:image'] || [];
-        const largestImage = images.length > 0 ? images[images.length - 1].label : '';
-
-        return {
-            id: entry.id.attributes['im:id'],
-            name: entry['im:name'].label,
-            url: entry.id.label,
-            iconUrl: largestImage,
-            artistName: entry['im:artist'].label,
-            releaseDate: entry['im:releaseDate']?.label,
-            description: entry.summary?.label,
-            formattedPrice: entry['im:price']?.label,
-            primaryGenreName: entry.category?.attributes.label,
-        };
-    }
-
-    static async searchApps(query: string, country: string = 'US', limit: number = 25): Promise<App[]> {
-        const params = {
-            term: query,
-            country: country,
-            media: 'software',
-            entity: 'software',
-            limit: limit,
-        };
-
-        const response = await axios.get<SearchResponse>(ITUNES_SEARCH_URL, { params });
-        return response.data.results.map(this.parseSearchResult);
-    }
-
-    static async getAppDetails(appId: string, country: string = 'US'): Promise<App | null> {
-        const params = {
-            id: appId,
-            country: country,
-        };
-
-        const response = await axios.get<SearchResponse>(ITUNES_LOOKUP_URL, { params });
-
-        if (response.data.resultCount === 0) {
-            return null;
-        }
-
-        return this.parseSearchResult(response.data.results[0]);
-    }
-
-    static async lookupMultipleApps(
-        appIds: string[],
-        country: string = 'US'
-    ): Promise<Map<string, App>> {
-        const params = {
-            id: appIds.join(','),
-            country: country,
-        };
-
-        const response = await axios.get<SearchResponse>(ITUNES_LOOKUP_URL, { params });
-        const appMap = new Map<string, App>();
-
-        for (const result of response.data.results) {
-            const app = this.parseSearchResult(result);
-            appMap.set(app.id, app);
-        }
-
-        return appMap;
-    }
-
-    static async getTrendingApps(
-        platform: Platform = 'iphone',
-        pricingType: PricingType = 'free',
-        country: string = 'US',
-        categoryId?: string,
-        limit: number = 25
-    ): Promise<App[]> {
-        const feedName = this.getFeedName(platform, pricingType);
-        const url = this.buildRssUrl(country, feedName, limit, categoryId);
-
-        const response = await axios.get<RssResponse>(url);
-        const entries = response.data.feed.entry || [];
-
-        return entries.map(this.parseRssEntry);
-    }
-
-    static async getAppReleaseInfo(
-        appId: string,
-        country: string = 'US'
-    ): Promise<{ releaseDate?: string; currentVersionReleaseDate?: string; version?: string } | null> {
-        const app = await this.getAppDetails(appId, country);
-
-        if (!app) {
-            return null;
-        }
-
-        return {
-            releaseDate: app.releaseDate,
-            currentVersionReleaseDate: app.currentVersionReleaseDate,
-            version: app.version,
-        };
-    }
-
-    static async getAppScreenshots(
-        appId: string,
-        country: string = 'US'
-    ): Promise<{ screenshotUrls: string[]; ipadScreenshotUrls: string[] } | null> {
-        const app = await this.getAppDetails(appId, country);
-
-        if (!app) {
-            return null;
-        }
-
-        return {
-            screenshotUrls: app.screenshotUrls || [],
-            ipadScreenshotUrls: app.ipadScreenshotUrls || [],
-        };
-    }
-}

package/src/types.ts

@@ -1,77 +0,0 @@
-export interface App {
-    id: string;
-    name: string;
-    url: string;
-    iconUrl: string;
-    artistName: string;
-    averageUserRating?: number;
-    userRatingCount?: number;
-    releaseDate?: string;
-    currentVersionReleaseDate?: string;
-    description?: string;
-    version?: string;
-    price?: number;
-    formattedPrice?: string;
-    primaryGenreName?: string;
-    genres?: string[];
-    screenshotUrls?: string[];
-    ipadScreenshotUrls?: string[];
-    bundleId?: string;
-    minimumOsVersion?: string;
-    fileSizeBytes?: string;
-    contentAdvisoryRating?: string;
-}
-
-export interface Category {
-    id: string;
-    name: string;
-    emoji: string;
-}
-
-export type Platform = 'iphone' | 'ipad' | 'mac' | 'tv';
-export type PricingType = 'free' | 'paid' | 'grossing';
-
-export interface Country {
-    code: string;
-    name: string;
-}
-
-export const APP_STORE_CATEGORIES: Category[] = [
-    { id: '6000', name: 'Business', emoji: '💼' },
-    { id: '6001', name: 'Weather', emoji: '🌤️' },
-    { id: '6002', name: 'Utilities', emoji: '🔧' },
-    { id: '6003', name: 'Travel', emoji: '✈️' },
-    { id: '6004', name: 'Sports', emoji: '⚽' },
-    { id: '6005', name: 'Social Networking', emoji: '👥' },
-    { id: '6006', name: 'Reference', emoji: '📚' },
-    { id: '6007', name: 'Productivity', emoji: '📊' },
-    { id: '6008', name: 'Photo & Video', emoji: '📷' },
-    { id: '6009', name: 'News', emoji: '📰' },
-    { id: '6010', name: 'Navigation', emoji: '🧭' },
-    { id: '6011', name: 'Music', emoji: '🎵' },
-    { id: '6012', name: 'Lifestyle', emoji: '🌟' },
-    { id: '6013', name: 'Health & Fitness', emoji: '💪' },
-    { id: '6014', name: 'Games', emoji: '🎮' },
-    { id: '6015', name: 'Finance', emoji: '💰' },
-    { id: '6016', name: 'Entertainment', emoji: '🎬' },
-    { id: '6017', name: 'Education', emoji: '🎓' },
-    { id: '6018', name: 'Books', emoji: '📖' },
-    { id: '6020', name: 'Medical', emoji: '🏥' },
-    { id: '6021', name: 'Magazines & Newspapers', emoji: '📰' },
-    { id: '6022', name: 'Catalogs', emoji: '📋' },
-    { id: '6023', name: 'Food & Drink', emoji: '🍔' },
-    { id: '6024', name: 'Shopping', emoji: '🛒' },
-];
-
-export const PLATFORMS: { value: Platform; label: string; emoji: string }[] = [
-    { value: 'iphone', label: 'iPhone', emoji: '📱' },
-    { value: 'ipad', label: 'iPad', emoji: '📲' },
-    { value: 'mac', label: 'Mac', emoji: '💻' },
-    { value: 'tv', label: 'Apple TV', emoji: '📺' },
-];
-
-export const PRICING_TYPES: { value: PricingType; label: string; emoji: string }[] = [
-    { value: 'free', label: 'Free', emoji: '🆓' },
-    { value: 'paid', label: 'Paid', emoji: '💵' },
-    { value: 'grossing', label: 'Top Grossing', emoji: '💰' },
-];

package/tsconfig.json

@@ -1,21 +0,0 @@
-{
-    "compilerOptions": {
-        "target": "ES2022",
-        "module": "commonjs",
-        "lib": ["ES2022"],
-        "outDir": "./dist",
-        "rootDir": "./src",
-        "strict": true,
-        "esModuleInterop": true,
-        "skipLibCheck": true,
-        "forceConsistentCasingInFileNames": true,
-        "resolveJsonModule": true,
-        "declaration": true,
-        "declarationMap": true,
-        "inlineSourceMap": true,
-        "noUnusedLocals": false,
-        "noUnusedParameters": false
-    },
-    "include": ["src/**/*"],
-    "exclude": ["node_modules", "dist"]
-}