Termux Puppeteer MCP服务器
一个Puppeter MCP（模型上下文协议）服务器，通过在Alpine Linux容器中运行Chromium，在Android Termux上运行 proot-distro.
为什么存在
标准Puppeteer MCP服务器无法在Android/Termux上运行，因为：
- Chrome的ARM版本不存在
- Puppeteer需要基于Chromium的浏览器
此解决方案在容器化环境中使用Alpine Linux运行Chromium，而MCP服务器在Termux中运行，并将命令桥接到Alpine。
快速设置
自动化安装 （推荐）：
bash setup.sh脚本将自动执行以下操作：
- 安装proot发行版
- 安装Alpine Linux
- 在Alpine中安装Chromium和Node.js
- 在Alpine安装Puppeter
- 在Termux中设置MCP服务器
- 创建配置文件
不需要设备根！
根据您的连接情况，大约需要5-10分钟。
手动设置
如果已经设置或更喜欢手动安装：
- ✅ 通过安装Alpine Linux
proot-distro - ✅ 铬安装在Alpine
- ✅ Termux和Alpine中的Node.js和npm
- ✅ Puppeter安装在Alpine
可用工具
服务器通过MCP提供这些Puppeteer工具：
- puppeteer_navigation -导航到URL并获取页面内容/标题
- 木偶戏 -截图（返回base64）
- puppeteer_pdf -从URL生成PDF（返回base64）
- 木偶师_评价 -在页面上下文中执行JavaScript
- 木偶戏 -点击页面上的元素
使用Claude代码
将此添加到您的Claude Code MCP设置中：
{
"mcpServers": {
"puppeteer": {
"command": "node",
"args": ["/data/data/com.termux/files/home/termux-puppeteer-mcp/index.js"]
}
}
}或者使用节点的绝对路径：
{
"mcpServers": {
"puppeteer": {
"command": "/data/data/com.termux/files/usr/bin/node",
"args": ["/data/data/com.termux/files/home/termux-puppeteer-mcp/index.js"]
}
}
}测试
您可以使用MCP检查器或运行以下命令来测试服务器：
node index.js服务器使用MCP协议通过stdio进行通信。
运作原理
- MCP服务器在Termux（原生Android环境）中运行
- 当一个工具被调用时，它会生成Puppeter JavaScript代码
- 代码在Alpine Linux中使用
proot-distro login alpine - Chromium在阿尔卑斯山以适当的旗帜运行(
--no-sandbox等等） - 结果通过MCP协议返回
示例命令
来自克劳德代码：
- “截取example.com的屏幕截图”
- “获取google.com的标题”
- “生成github.com的PDF”
- “单击example.com上的登录按钮”
备注
- 无需设备根（proot在没有根的情况下工作）
- Chromium以无头模式运行
- 屏幕截图是压缩的JPEG（质量60%，800x600），以符合MCP令牌限制
- PDF以base64格式返回
- 关于清理绑定的证明警告是正常的，可以忽略
文件
setup.sh-自动安装脚本index.js-MCP服务器实现package.json-Node.js依赖关系.mcp.json-Claude Code的MCP服务器配置README.md-此文件SETUP.md-详细的设置指南
共享
要在线共享此设置，请执行以下操作：
- 这
setup.sh脚本包含所有安装步骤 - 用户可以在任何Termux安装上运行它
- 适用于无root的ARM64 Android设备
许可证
MIT-随意使用和修改