JinDaGe - AppInsightMCP MCP Details

article

README

🚀 应用市场情报 MCP 服务器

本 MCP 服务器通过分析苹果应用商店和谷歌 Play 商店的数据，提供全面的市场情报。能获取应用程序、市场趋势、竞争对手和用户反馈等信息，覆盖主要移动应用市场。

🚀 快速开始

启动 MCP 服务器：

node src/server.js

该服务器可与 Claude Desktop 集成，提供完整的市场情报功能。

✨ 主要特性

分析苹果应用商店和谷歌 Play 商店的数据，提供全面市场情报。
覆盖多个主要移动应用市场，可获取应用程序、市场趋势、竞争对手和用户反馈等信息。
实现了丰富的 API 功能，涵盖苹果应用商店和谷歌 Play 商店。

📦 安装指南

使用 Smithery 安装

访问 Smithery 平台。
按照指引完成安装和配置。

使用 Docker 安装

拉取镜像：

docker pull jiantaofu/appinsightmcp

启动容器：

docker run -p 8080:8080 jiantaofu/appinsightmcp

使用 NPX 安装

安装依赖：

npm install app-insight-mcp --save-dev

配置项目并运行：

{
  "scripts": {
    "start": "app-insight-mcp start"
  }
}

💻 使用示例

基础用法

以下是一些使用场景的示例：

获取免费 iOS 应用：

{
  "command": "app-store-list",
  "params": {
    "category": "games",
    "country": "us"
  }
}

获取付费 Android 游戏：

{
  "command": "google-play-list",
  "params": {
    "collection": "top_paid",
    "language": "en"
  }
}

📚 详细文档

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 | 获取应用程序的详细信息 | | 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-inspect --server http://localhost:8080

使用 mcp-cli 进行测试

安装 mcp-cli：

npm install -g mcp-cli

执行以下命令测试服务器：

mcp-cli --url=http://localhost:8080

构建方式

使用 Docker 进行构建：

docker build -t app-insight-mcp .

错误处理

该工具包含以下错误处理机制：

网络连接错误
请求参数错误
API 调用失败
数据解析错误

🤝 贡献指南

欢迎参与项目贡献！请参考贡献文档了解具体流程。

📄 许可证

MIT

AppInsightMCP