🚀 应用市场情报 MCP
一个提供全面市场情报的 MCP 服务器，通过分析来自苹果应用商店和谷歌 Play Store 的数据，帮助您获取应用程序、市场趋势、竞争对手以及用户反馈的洞察力。
🚀 快速开始
启动 MCP 服务器：
node src/server.js
该服务器提供可以通过任何 MCP 客户端使用的工具。例如，使用 Claude 桌面版，您可以：
- 在两个商店中搜索应用程序
- 获取应用程序的详细信息
- 阅读评论和评分
- 查找类似的应用程序
- 检查应用程序的隐私和权限
- 以及其他更多功能
✨ 主要特性
本 MCP 服务器可提供全面的应用市场情报，通过分析苹果应用商店和谷歌 Play Store 的数据，让您深入了解应用程序、市场趋势、竞争对手和用户反馈。
📦 安装指南
通过 Smithery 安装
- 访问 Smithery
- 搜索并安装
@JiantaoFu/appinsightmcp项目 - 配置项目参数并启动服务
使用 Docker 安装
docker pull your-docker-image
docker run -p 3000:3000 your-docker-image
使用 NPX 安装
- 确保已安装 Node.js 和 npm
- 使用以下命令运行项目：
npx your-package-name -- --port 3000
💻 使用示例
基础用法
// 获取免费 iOS 应用排行榜
{
"app": "netflix",
"category": "ENTERTAINMENT"
}
// 获取 Google Play 中的应用商店评论
{
"app": "com.example.game",
"language": "en-US"
}
📚 详细文档
API 覆盖范围
苹果应用商店 API 覆盖范围
| API 功能 | 已实现 | MCP 工具名称 | 描述 |
|---|---|---|---|
| app | ✅ | app-store-details | 获取苹果应用商店应用程序的详细信息 |
| list | ✅ | app-store-list | 从 iTunes 集合中检索应用程序 |
| search | ✅ | app-store-search | 在苹果应用商店中搜索应用程序 |
| developer | ✅ | app-store-developer | 根据开发者获取应用程序 |
| privacy | ✅ | app-store-privacy | 获取应用程序的隐私详情 |
| suggest | ✅ | app-store-suggest | 获取搜索建议 |
| similar | ✅ | app-store-similar | 获取类似的应用程序 |
| reviews | ✅ | app-store-reviews | 获取应用程序评论 |
| ratings | ✅ | app-store-ratings | 获取应用程序评分 |
| versionHistory | ✅ | app-store-version-history | 获取应用程序版本历史 |
谷歌 Play API 覆盖范围
| API 功能 | 已实现 | MCP 工具名称 | 描述 |
|---|---|---|---|
| app | ✅ | google-play-details | 获取谷歌 Play 商店中应用程序的详细信息 |
| list | ✅ | google-play-list | 从集合中检索应用程序 |
| search | ✅ | google-play-search | 搜索应用程序 |
| developer | ✅ | google-play-developer | 根据开发者获取应用程序 |
| suggest | ✅ | google-play-suggest | 获取搜索建议 |
| reviews | ✅ | google-play-reviews | 获取应用程序评论 |
| similar | ✅ | google-play-similar | 获取类似的应用程序 |
| permissions | ✅ | google-play-permissions | 获取应用程序权限 |
| datasafety | ✅ | google-play-datasafety | 获取数据安全信息 |
| categories | ✅ | google-play-categories | 获取类别列表 |
🔧 技术细节
测试
使用 MCP Inspector 进行测试
通过以下步骤使用 MCP Inspector：
- 下载并安装 MCP Inspector
- 打开 MCP Inspector 并连接到您的 MCP 服务器
- 在工具栏中选择适当的 API 工具进行测试
使用 mcp-cli 进行测试
- 安装 Node.js 和 npm
- 全局安装 mcp-cli：
npm install -g mcp-cli
- 使用以下命令调用 MCP 服务器：
mcp-cli --server http://localhost:3000 --tool app-store-details --params '{"id":"123456"}'
错误处理
所有工具均包含错误处理机制，能够捕获并返回详细的错误信息。例如：
try {
// 调用 API 的代码
} catch (error) {
console.error('Error:', error.message);
}
📄 许可证
MIT License
🌟 贡献
我们欢迎社区贡献，包括但不限于以下方面：
- 实现缺失的 API 功能
- 改进错误处理机制
- 增加更多 API 能力
- 增强文档和示例代码