返回 MCP 目录
public公开dns本地运行

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

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端