ASO MCP Server

关键词

Google Play 数据检索LLM 集成代理轮换JSON-RPC 服务元数据验证

使用说明（Markdown 格式）

  • 项目简介

    • 这是一个基于 MCP 的后端服务器实现，面向 LLM 客户端，提供对 Google Play Store 的应用发现、详细信息、用户评价、关键词建议以及元数据校验等工具的访问能力，方便将外部数据和功能整合到对话式 AI 应用中。

  • 主要功能点

    • 工具集成：提供 google-play-suggest、google-play-search、google-play-list、google-play-app、google-play-reviews 等工具，覆盖关键词建议、搜索、列表、详情和评价等常见需求。
    • 元数据校验：提供 google-play-validate-title、google-play-validate-short-description、google-play-validate-full-description，帮助检测标题和描述是否符合 Google Play 的长度限制。
    • 参考数据：提供 get-google-play-languages、get-google-play-countries、get-google-play-countries-with-languages，便于客户端了解支持的语言与国家。
    • 兼容性与扩展：通过结构化输出方便 LLM 进行进一步处理，且支持代理轮换以应对请求限流或区域限制。
    • 传输与通信：服务器通过 MCP 的机制暴露工具，客户端可通过 JSON-RPC 与之交互，当前示例使用标准输入输出传输 (stdio)。

  • 安装步骤

    • 确保使用 Python 3.14+。
    • 克隆仓库，进入项目目录，安装依赖并运行服务器（通常通过 uv 提供的能力来启动）。
    • 安装依赖的命令示例（简述，非复制粘贴代码）：用 uv 同步安装或通过 pip 安装开发依赖。
    • 运行服务器：在项目根目录执行 uv run python server.py，服务器将监听并等待 MCP 客户端的请求。

  • 服务器配置（MCP 客户端需要提供的配置信息，示例为 JSON 结构，描述性信息，实际客户端不需要你理解代码即可使用）

    • 服务器名称：aso
    • 启动命令(command)：uv
    • 参数(args)：["run", "python", "server.py"]
    • 工作目录(cwd)："/path/to/aso-mcp-python"
    • 备注：若需要代理轮换，可通过环境变量 ASO_MCP_PROXIES 指定代理池；MCP 客户端仅需知道启动命令与参数即可连接到服务器。

    示例 JSON（用于 MCP 客户端指定服务器启动方式的结构描述，不是可执行代码）： { "mcpServers": { "aso": { "command": "uv", "args": ["run", "python", "server.py"], "cwd": "/path/to/aso-mcp-python" } } }

  • 基本使用方法

    • 启动后，客户端通过 MCP 协议与服务器通信，请求包括读取资源、执行工具、获取提示等，服务器返回 JSON-RPC 风格的响应或通知。
    • 常用操作包括调用搜索、获取应用详情、获取用户评价、关键词建议，以及进行元数据的长度校验。
    • 如需调试或查看日志，可在服务器端开启调试级别日志，帮助排查请求、代理选择与错误情况。

  • 其他注意

    • 服务器目前是原型实现，关注点在 MCP 接口的工具暴露、结构化输出以及对外部 API 的代理化访问。
    • 如要在本地开发环境中验证，请确保环境变量 ASO_MCP_PROXIES（如有需要）按需配置。

服务器信息

访问项目