应用商店数据服务

应用商店MCP服务器

⚠️ 重要安全通知：永远不要将API密钥提交到版本控制。此程序包需要通过环境变量设置API密钥。

MCP（模型上下文协议）服务器，通过应用商店API提供对苹果应用商店和谷歌Play商店应用商店数据的访问。

特性

• 自动完成：根据搜索词获取应用程序名称建议
• 搜索：在应用商店中搜索应用
• 详情：获取特定应用程序的详细信息
• 评论：获取应用程序的用户评论
• 🚀 智能高速缓存：机内LRU缓存减少了API调用并提高了性能
• 📄 分页：可配置的页面大小可将代币消耗量减少60%+
• ⚡ 演出：缓存命中响应立即返回

安装

此MCP服务器旨在与MCP兼容的应用程序一起使用，如Claude Desktop、带有Copilot的VS Code或其他MCP客户端。

MCP客户端配置

将此服务器添加到MCP客户端配置中：

克劳德桌面

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "app-store": {
      "command": "npx",
      "args": ["-y", "@andrewlwn77/app-store-mcp"],
      "env": {
        "APP_STORE_API_KEY": "your-api-key-here",
        "CACHE_ENABLED": "true",
        "CACHE_TTL_SECONDS": "300",
        "CACHE_MAX_ENTRIES": "100", 
        "RESULTS_PER_PAGE": "10"
      }
    }
  }
}

VS代码与GitHub Copilot

添加到MCP配置（用户设置JSON或 .vscode/mcp.json):

{
  "servers": {
    "app-store": {
      "type": "stdio",
      "command": "npx", 
      "args": ["-y", "@andrewlwn77/app-store-mcp"],
      "env": {
        "APP_STORE_API_KEY": "your-api-key-here",
        "CACHE_ENABLED": "true",
        "CACHE_TTL_SECONDS": "300",
        "CACHE_MAX_ENTRIES": "100",
        "RESULTS_PER_PAGE": "10"
      }
    }
  }
}

直接安装（用于开发）

npm install -g @andrewlwn77/app-store-mcp

地方发展

git clone <repository-url>
cd app-store-mcp
npm install
npm run build

配置

必需：您必须设置 APP_STORE_API_KEY 运行服务器之前的环境变量。

1. 从获取API密钥 RapidAPI应用商店
2. 设置环境变量：
   复制

   # Option 1: Export in your shell
   export APP_STORE_API_KEY="your-api-key-here"
   
   # Option 2: Create a .env file (for local development)
   echo "APP_STORE_API_KEY=your-api-key-here" > .env
   

⚠️ 安全：永远不要承诺你的 .env 文件或API密钥到版本控制！

配置

服务器支持几个环境变量进行性能调优：

配置示例

# High-performance configuration
export CACHE_TTL_SECONDS=600
export RESULTS_PER_PAGE=5
export CACHE_MAX_ENTRIES=200

# Disable caching for development/debugging
export CACHE_ENABLED=false

用法

测试服务器

# For local development and testing
npm start

# For development with auto-reload
npm run dev

# Test the server directly (requires MCP client)
npx -y @andrewlwn77/app-store-mcp

备注：此服务器旨在通过MCP客户端使用。直接执行将通过stdin等待MCP协议消息。

可用工具

1. app_store_autocomplete

根据搜索词获取应用程序名称建议。

参数：

• store （必填）：“苹果”或“谷歌”
• term （必填）：自动补全的搜索词
• language （可选）：语言代码（默认值：“en”）
• page （可选）：页码，从1开始（默认值：1）
• pageSize （可选）：每页结果（默认值：从 RESULTS_PER_PAGE)

2. app_store_search

在应用商店中搜索应用。

参数：

• store （必填）：“苹果”或“谷歌”
• term （必填）：搜索词
• language （可选）：语言代码（默认值：“en”）
• page （可选）：页码，从1开始（默认值：1）
• pageSize （可选）：每页结果（默认值：从 RESULTS_PER_PAGE)

3. app_store_details

获取特定应用程序的详细信息。

参数：

• store （必填）：“苹果”或“谷歌”
• id （必填）：应用程序ID（iOS的捆绑包ID，Android的包名称）
• language （可选）：语言代码（默认值：“en”）

4. app_store_reviews

获取特定应用程序的评论。

参数：

• store （必填）：“苹果”或“谷歌”
• id （必填）：应用程序ID（iOS的捆绑包ID，Android的包名称）
• language （可选）：语言代码（默认值：“en”）
• page （可选）：页码，从1开始（默认值：1）
• pageSize （可选）：每页结果（默认值：从 RESULTS_PER_PAGE)

示例用法

一旦配置了MCP客户端，您就可以使用自然语言与工具进行交互：

• “在Google Play商店搜索冥想应用程序”
• “在苹果应用商店获取Spotify的详细信息”
• “显示Snapchat在Android上的最新评论”
• “查找iOS上‘照片编辑’的应用建议”

服务器将自动处理API调用并返回格式化的结果。

配置

可以使用环境变量配置服务器：

• APP_STORE_API_KEY：应用商店API的RapidAPI密钥（必需）

发展

项目结构

app-store-mcp/
├── src/
│   ├── index.ts      # Main MCP server implementation
│   └── types.ts      # TypeScript type definitions
├── package.json
├── tsconfig.json
├── .env.example
└── README.md

类型安全

此服务器是用TypeScript编写的，为以下内容提供了完全的类型安全：

• API参数
• API响应
• 错误处理
• 商店验证（仅接受“苹果”或“谷歌”）

许可证

麻省理工学院