使用说明

项目简介

AppInsightMCP 是一个基于 Model Context Protocol (MCP) 构建的应用后端服务器，旨在为LLM应用提供应用市场情报数据。它通过集成 Apple App Store 和 Google Play Store 的数据抓取能力，提供了一系列工具，允许LLM客户端查询和分析应用市场数据，例如应用详情、应用榜单、应用搜索、用户评价、开发者信息等。这使得LLM能够理解和利用最新的应用市场趋势和竞争情报。

主要功能点

应用商店数据聚合: 统一访问 Apple App Store 和 Google Play Store 的数据。
丰富的工具集: 提供应用搜索、详情查询、榜单获取、评价分析、开发者信息查询等多种工具，覆盖应用市场情报的关键方面。
结构化数据输出: 工具返回结构化的JSON数据，方便LLM客户端解析和利用。
易于集成: 通过标准的MCP协议和JSON-RPC通信，可以方便地与各种MCP客户端集成，例如 Claude Desktop。
灵活部署: 支持多种部署方式，包括 NPX 和 Docker，方便用户根据自身环境选择合适的部署方案。

安装步骤

安装 Node.js 和 npm: 确保你的环境中已安装 Node.js 和 npm (Node.js 包管理器)。你可以从 nodejs.org 下载并安装。
下载仓库代码: 从 GitHub 仓库 https://github.com/JiantaoFu/AppInsightMCP 下载代码到本地。你可以使用 'git clone https://github.com/JiantaoFu/AppInsightMCP' 命令克隆仓库。
进入项目目录: 使用 'cd AppInsightMCP' 命令进入项目目录。
安装依赖: 在项目根目录下运行 'npm install' 命令安装项目所需的依赖包。
启动 MCP 服务器: 运行 'node src/server.js' 命令启动 MCP 服务器。服务器默认通过标准输入输出 (stdio) 与客户端通信。

服务器配置

MCP 客户端需要配置服务器的启动命令才能连接 AppInsightMCP 服务器。以下是针对不同 MCP 客户端 (以 Claude Desktop 为例) 的配置信息，你需要将这些配置添加到你的 MCP 客户端配置文件中。

Claude Desktop 配置示例 (claude_desktop_config.json):

使用 NPX 启动 (推荐):

{
  "mcpServers": {
    "app-insight-mcp": {  // 服务器名称，客户端用此名称引用
      "command": "npx",  // 启动命令，这里使用 npx 运行 npm 包
      "args": [          // 命令参数
        "-y",           // 自动确认安装 npm 包
        "@jiantaofu/app-insight-mcp" //  要运行的 npm 包名称 (注意作者用户名已更新为 jiantaofu)
      ]
    }
  }
}

使用 Docker 启动 (如果已构建 Docker 镜像):

{
  "mcpServers": {
    "app-insight-mcp": {  // 服务器名称
      "command": "docker", // 启动命令，这里使用 docker
      "args": [          // 命令参数
        "run",          // docker run 子命令
        "-i",           //  保持STDIN打开，即使未连接
        "--rm",         //  容器退出时自动删除容器
        "app-insight-mcp" // Docker 镜像名称
      ]
    }
  }
}

注意:

请确保你的 MCP 客户端配置文件路径正确，并根据客户端文档进行配置。
'server name' (例如 "app-insight-mcp") 可以自定义，客户端会使用这个名称来调用服务器提供的工具。
'command' 和 'args' 必须根据你的实际部署方式进行调整。 NPX 方式最简单，Docker 方式需要你先构建 Docker 镜像 (参考仓库 README 构建步骤)。
如果使用 NPX 方式，首次运行时 npm 会自动下载 '@jiantaofu/app-insight-mcp' 包，请确保网络连接正常。

基本使用方法

启动 MCP 服务器并配置好客户端后，你就可以在 MCP 客户端中使用 AppInsightMCP 提供的工具了。

工具调用示例 (JSON 格式):

以下是一些工具调用的示例，你可以将这些 JSON 对象发送给 MCP 客户端来调用相应的工具。

搜索 App Store 应用 (app-store-search):

{
  "name": "app-store-search",
  "params": {
    "term": "Instagram",
    "country": "us",
    "num": 5
  }
}

这个例子会在美国 App Store 搜索 "Instagram" 应用，并返回最多 5 个结果。

获取 Google Play 应用详情 (google-play-details):

{
  "name": "google-play-details",
  "params": {
    "appId": "com.instagram.android",
    "country": "us"
  }
}

这个例子会获取 Google Play 上 App ID 为 "com.instagram.android" 的应用的详细信息。

获取 App Store 应用评价 (app-store-reviews):

{
  "name": "app-store-reviews",
  "params": {
    "id": 389801252, // Instagram App ID
    "country": "us",
    "sort": "recent"
  }
}

这个例子会获取美国 App Store 上 Instagram 应用的最新评价。

更多工具和参数:

请参考仓库的 'README.md' 文件中的 "API Coverage" 表格，了解 AppInsightMCP 提供的所有工具名称、描述和参数。你可以根据需要组合不同的工具和参数，以满足你的应用市场情报需求。

通过 MCP 客户端界面操作:

更方便的方式是直接在支持 MCP 协议的客户端 (例如 Claude Desktop) 的界面中操作。客户端通常会提供工具列表和参数输入界面，你只需要选择相应的工具并填写参数即可，无需手动编写 JSON。

关键词