Skip to main content
Glama
shuaici

BeautifulChina MCP

by shuaici
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

BeautifulChina MCP

Cursor 用 MCP 驱动 bc_* 工具，自动化测试 BeautifulChina Android App（adb + uiautomator2）。测试清单见 docs/test-checklist.md。

安装

git clone git@github.com:shuaici/BeautifulChinaMCP.git
cd BeautifulChinaMCP
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
adb devices   # 确认手机已连接

环境：macOS/Linux · Python 3.10–3.12 · adb · 手机已装 com.kuen.beautifulchina · USB 调试已开。

Related MCP server: uiautomator2 MCP Server

配置 Cursor

command 用 venv 里 python3 的绝对路径，args 指向 server.py 绝对路径。改完重启 Cursor。

项目级（推荐）：BeautifulChina/.cursor/mcp.json

全局：~/.cursor/mcp.json

{
  "mcpServers": {
    "beautiful-china": {
      "command": "/path/to/BeautifulChinaMCP/.venv/bin/python3",
      "args": ["/path/to/BeautifulChinaMCP/server.py"],
      "env": {
        "BC_SCREENSHOT_DIR": "~/Downloads/BC",
        "BC_DEVICE_ID": ""
      }
    }
  }
}

环境变量

说明

BC_SCREENSHOT_DIR

截图目录，默认 ~/Downloads/BC

BC_DEVICE_ID

多设备时填序列号，留空自动选第一台

对 Agent 说 「按清单测一遍」 → 默认 快速模式 + P0（bc_assert_text 判定，失败才截图）。要说 「完整模式」 才每步截图。

工具

工具

说明

bc_launch / bc_terminate

启停 App

bc_screenshot

截图，name 为文件名前缀

bc_list_elements

列元素，返回 activity；include_non_clickable=true 含文字

bc_click

text / resource_id / 坐标点击

bc_wait / bc_assert_text

等待 / 断言文字

bc_swipe / bc_press_back

滑动 / 返回

bc_device_info / bc_setup

设备健康检查 / 初始化（通常自动）

常见问题

现象

处理

点击无反应，bc_click 失败并带 manual_steps

小米开 USB 调试（安全设置）；验证 adb shell input tap 500 500 不报错

adb devices 空 / unauthorized

换线重插、手机点允许、adb kill-server && adb start-server

看不到省份名文字

bc_list_elements include_non_clickable=true

MCP 红灯

检查 mcp.json 绝对路径、venv 已 pip install

Python 3.14 装依赖失败

改用 3.12 重建 venv

P0 实测（2026-07-20，小米 MIUI）

8/8 通过（启动 · 地区 · 省份 · 景点 · 返回 · 世界遗产 · 答题 · 我的）

截图（docs/screenshots/）：
地区首页 省份详情 景点详情 世界遗产 答题 Hub

运行时截图带时间戳写入 ~/Downloads/BC/。

License

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityStale
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • lazy-mobile-mcp

    leaf76
    A
    license
    Not graded
    quality
    C
    maintenance
    Local MCP server for Android and iOS mobile automation and performance telemetry, enabling device control (screenshot, tap, swipe, input, app launch) and metric collection (CPU, memory, launch time) via ADB, simctl, and WebDriverAgent with SQLite session history.
    9 npm
    1
    MIT

  • uiautomator2 MCP Server

    tanbro
    A
    license
    Not graded
    quality
    C
    maintenance
    An MCP server that provides tools for controlling Android devices using uiautomator2, enabling AI to automate tasks like tapping, swiping, and managing apps.
    72 PyPI
    47
    Apache 2.0

  • DroidPilot

    LioMatthys
    A
    license
    A
    quality
    D
    maintenance
    Drive an Android phone over ADB and expose it to AI agents via MCP, enabling natural language-driven interaction for native app testing.
    13
    MIT