应用商店MCP服务器
](https://www.npmjs.com/package/@andrewlwn77/app-store-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
cd app-store-mcp
npm install
npm run build配置
必需：您必须设置 APP_STORE_API_KEY 运行服务器之前的环境变量。
- 从获取API密钥 RapidAPI应用商店
- 设置环境变量：
# 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密钥到版本控制！
配置
服务器支持几个环境变量进行性能调优：
| 变量 | 描述 | 默认值 | 示例 |
|---|---|---|---|
APP_STORE_API_KEY | 必需 -您的RapidAPI密钥 | - | abc123def456 |
CACHE_ENABLED | 启用/禁用响应缓存 | true | false |
CACHE_TTL_SECONDS | 缓存进入生存时间 | 300 | 600 |
CACHE_MAX_ENTRIES | 最大缓存条目数（LRU驱逐） | 100 | 50 |
RESULTS_PER_PAGE | 默认分页页面大小 | 10 | 5 |
配置示例
# 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响应
- 错误处理
- 商店验证（仅接受“苹果”或“谷歌”）
许可证
麻省理工学院