looktap

本地服务

lakpriya.com开发工具33 天前更新

代码仓库访问官网

关于 looktap

looktap 是用于控制 iPhone 和 Android 设备应用的 MCP 服务，支持模拟器和仿真器，面向需要检查屏幕、执行操作或查看日志与崩溃信息的 AI Agent。

主要功能

01以文本读取屏幕内容
02按标签点击控件
03输入、滑动与滚动
04截取屏幕图像
05检查日志与崩溃信息
06查看 CPU、内存与帧性能

适用场景

01操作已连接手机上的应用
02在模拟器或仿真器中操作应用
03检查操作后的屏幕
04排查应用崩溃与性能

MCP 相关

向 MCP 客户端提供设备交互和检查工具，包括读取屏幕、点击、输入、截图、日志及崩溃报告。该服务会安装并运行 looktap CLI。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "lakpriya1s-looktap": {
      "command": "npx",
      "args": [
        "-y",
        "@looktap/mcp"
      ]
    }
  }
}

启动命令npx -y @looktap/mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@looktap/mcp0.7.1stdio

工具

收录的工具列表 · 更新于 1 周前

参数	类型	必填	说明
all	boolean	否	包含未标记的元素
device	string	否	启动多个模拟器时使用的模拟器 UDID 或 adb 序列号。后续调用会沿用此值。
platform	enum	否	同时启动 iOS 和 Android 设备时使用。后续调用会沿用此值。ios \| android

详细介绍

@looktap/mcp

looktap 的 MCP 服务：让你的 AI Agent 查看、使用并控制手机上的应用，包括 iPhone 或 Android 设备（模拟器、虚拟设备或真机）及其上的任意应用。它会将屏幕内容读取为文本、按标签点击、输入文本、滑动、截取屏幕截图，并读取日志和崩溃信息。

此软件包只负责启动服务。其他所有功能都由它安装的 @looktap/cli 提供，因此你始终能使用最新版本的 looktap。如果你已安装 CLI，looktap mcp 就是同一个服务。

设置

Claude Code

claude mcp add looktap -- npx -y @looktap/mcp

Claude Desktop、Cursor、VS Code 和其他客户端

{
  "mcpServers": {
    "looktap": { "command": "npx", "args": ["-y", "@looktap/mcp"] }
  }
}

Claude Desktop：~/Library/Application Support/Claude/claude_desktop_config.json
Cursor：~/.cursor/mcp.json

桌面应用启动服务时使用的 PATH 最小化，因此如果它找不到 npx（使用 nvm 时很常见），请运行 npm install -g @looktap/cli 安装 CLI，然后粘贴 looktap mcp --config 输出的配置。该配置使用绝对路径。

要求

Node 18+
iPhone：需要 macOS 和 Xcode，以及模拟器或已配对的 iPhone（免费的 Apple ID 即可）。looktap 工具的 boot "iPhone 16 Pro" 命令会启动模拟器，devices 会列出已连接的设备
Android：需要 adb，以及模拟器（boot <AVD name> 会启动模拟器）或启用了 USB 或无线调试的手机

工具

ls、tap、tap_xy、long_press、fill、type、key、hide_keyboard、swipe、scroll_to、back、home、wait、screenshot（返回图像）、logs、crashes、perf（CPU、内存、线程或帧与卡顿），以及用于执行其他命令的 looktap（devices、boot、capabilities、stop、expect、test、apps、launch --time 等）。除非设置 ls: false，操作都会返回稳定后的屏幕。