Back to MCP directory
publicPublicdnsLocal runtime

xiaozhi-autoglm-mcp

基于Open-AutoGLM构建的安卓设备自动化MCP服务,通过ADB连接手机并调用视觉模型,可接入小智AI实现智能控制。

article

README

🚀 小智-AutoGLM-mcp

这是一个基于 Open-AutoGLM 构建的小智MCP服务。该服务作为MCP服务,可接入小智AIxiaozhi-esp32-server ,并被小智调用。

🚀 快速开始

✨ 环境准备

1. ADB (Android Debug Bridge)

  • 下载官方 ADB 安装包,并解压到自定义路径。
  • 配置环境变量:
    • MacOS 配置方法:在 Terminal 或者任何命令行工具里执行以下命令:
# 假设解压后的目录为 ~/Downlaods/platform-tools。如果不是请自行调整命令。
export PATH=${PATH}:~/Downloads/platform-tools
- **Windows 配置方法**:可参考 [第三方教程](https://blog.csdn.net/x2584179909/article/details/108319973) 进行配置。

2. Android 7.0+ 的设备或模拟器,并启用 开发者模式USB 调试

  • 开发者模式启用:通常启用方法是,找到 设置-关于手机-版本号 然后连续快速点击 10 次左右,直到弹出弹窗显示“开发者模式已启用”。不同手机会有些许差别,如果找不到,可以上网搜索一下教程。
  • USB 调试启用:启用开发者模式之后,会出现 设置-开发者选项-USB 调试,勾选启用。
  • 部分机型注意事项:部分机型在设置开发者选项以后,可能需要重启设备才能生效。可以测试一下:将手机用USB数据线连接到电脑后,使用 adb devices 查看是否有设备信息,如果没有说明连接失败。

⚠️ 重要提示

请务必仔细检查相关权限。

权限

3. 安装 ADB Keyboard(用于文本输入)

下载 安装包 并在对应的安卓设备中进行安装。注意,安装完成后还需要到 设置-输入法 或者 设置-键盘列表 中启用 ADB Keyboard 才能生效。

📦 部署准备工作

1. 安装依赖

conda remove -n autoglm --all -y
conda create -n autoglm python=3.10 -y
conda activate autoglm

pip install -r requirements.txt 

2. 配置 ADB

  • 确认 USB数据线具有数据传输功能,而不是仅有充电功能。
  • 确保已安装 ADB 并使用 USB数据线 连接设备:
# 检查已连接的设备
adb devices

# 输出结果应显示你的设备,如:
# List of devices attached
# emulator-5554   device

3. 配置视觉模型和小智MCP接入点

  • 复制 config.yaml.config.yaml 文件。
  • 登录小智AI或者你私有化部署的智控台,获取智能体的MCP接入点地址。
  • 编辑 .config.yaml 文件,将获取到的MCP接入点地址替换到 mcp_endpoint 字段中。
  • 如果你的 .config.yaml 选择了 ChatGLMVLLM 作为视觉语言大模型,那么请前往智谱AI平台,获取你的密钥。请确保账户余额充足,否则会导致调用失败。
  • 编辑 .config.yaml 文件,将获取到的密钥替换到 VLLM 下的 ChatGLMVLLM 下的 api_key 字段中。

4. 运行服务

  • Linux/macOS
./start_mcp_service.sh
  • Windows
python mcp_pipe.py mobile_agent_server.py
help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client