安卓屏幕分析服务

AutoGLM MCP Server 是一款通过MCP协议提供安卓屏幕分析功能的服务,适用于AI代理中的屏幕内容理解和交互操作。

  • by xiangaoole
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 xiangaoole/autoglm-mcp

使用说明

AutoGLM MCP服务器

通过MCP协议的Android屏幕分析功能。

安装

选项1:使用uvx(推荐)

无需手动安装。只需添加到AI代理MCP配置中:

{
  "mcpServers": {
    "autoglm-mcp": {
      "command": "uvx",
      "args": ["autoglm-mcp"],
      "env": {
        "AUTOGLM_BASE_URL": "https://api.z.ai/api/paas/v4",
        "AUTOGLM_MODEL": "autoglm-phone-multilingual",
        "AUTOGLM_APIKEY": "your-api-key-here"
      }
    }
  }
}

选项2:pip安装

pip install autoglm-mcp

然后配置AI代理MCP:

{
  "mcpServers": {
    "autoglm-mcp": {
      "command": "autoglm-mcp",
      "env": {
        "AUTOGLM_BASE_URL": "https://api.z.ai/api/paas/v4",
        "AUTOGLM_MODEL": "autoglm-phone-multilingual",
        "AUTOGLM_APIKEY": "your-api-key-here"
      }
    }
  }
}

环境变量

变量 描述 默认值
AUTOGLM_APIKEY API密钥(必需) -
AUTOGLM_BASE_URL API终点 https://api.z.ai/api/paas/v4
AUTOGLM_MODEL 型号名称 autoglm-phone-multilingual

用法

确保您的手机已通过ADB连接,然后使用 aiAsk AI代理中的工具:

  • “单击搜索按钮的坐标是多少?”
  • “如何打开设置?”

本地开发与调试

先决条件

  • Python>=3.10
  • Node.js>=18(用于MCP检查器)
  • 安装ADB并连接电话(adb devices 显示您的设备)

从源代码安装

cd mcp
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

MCP检查员(推荐)

MCP检查员 是MCP服务器的官方可视化调试工具,就像MCP的Postman一样。

npx @modelcontextprotocol/inspector \
  -e AUTOGLM_APIKEY="your-api-key-here" \
  -e AUTOGLM_BASE_URL="https://api.z.ai/api/paas/v4" \
  -e AUTOGLM_MODEL="autoglm-phone-multilingual" \
  -- \
  /path/to/file/mcp/.venv/bin/python -m autoglm_mcp.server

然后打开 http://localhost:6274 在浏览器中:

  1. 点击 连接 连接到服务器
  2. 切换到 工具 选项卡——您应该看到 aiAsk 工具
  3. 输入一个问题(例如。 "What is on the screen?")然后单击 运行工具
  4. 检查左侧面板中的JSON-RPC请求/响应

使用本地mcp服务器

"autoglm-mcp": {
  "command": "/path/to/file/mcp/.venv/bin/python",
  "args": [
    "-m",
    "autoglm_mcp.server"
  ],
  "env": {
    "AUTOGLM_BASE_URL": "https://api.z.ai/api/paas/v4",
    "AUTOGLM_MODEL": "autoglm-phone-multilingual",
    "AUTOGLM_APIKEY": "xxx"
  }
}