mcp_server_adb

silionXi/mcp_server_adb

3.1

If you are the rightful owner of mcp_server_adb and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

This project is an Android ADB server based on the Model Context Protocol (MCP), offering device management and automation testing capabilities.

MCP Server ADB 项目

项目简介

这是一个基于 MCP (Model Context Protocol) 的 Android ADB 服务器项目，提供 Android 设备管理和自动化测试功能。

功能特性

  • Android 设备连接和管理
  • 屏幕截图和录制
  • 设备操作自动化
  • 文件传输和管理
  • 应用安装和卸载
  • 性能监控和分析

项目结构

mcp_server_adb/
├── .cursor/              # Cursor 编辑器配置
│   └── rules/           # 项目规则配置
├── src/                  # 源代码目录
│   ├── __init__.py      # 包初始化文件
│   ├── config/          # 配置管理模块
│   │   ├── __init__.py
│   │   └── settings.py  # 基础配置管理
│   ├── adb/             # ADB操作模块
│   │   ├── __init__.py
│   │   └── client.py    # ADB客户端核心
│   ├── handlers/        # 请求处理模块
│   │   ├── __init__.py
│   │   └── device_handlers.py  # 设备请求处理器
│   └── server.py        # MCP服务器主入口
├── main.py              # 项目启动脚本
├── requirements.txt     # 项目依赖包
├── .cursorignore        # Cursor 忽略文件配置
└── README.md           # 项目说明文档

更新日志

[2024-12-19] - Cursor MCP配置完成

  • 新增功能: 完成Cursor中MCP服务器配置
  • 新增文件:
    • verify_cursor_config.py - Cursor配置验证脚本
  • 技术改进:
    • 更新Cursor MCP配置文件 (/home/lsl/.cursor/mcp.json)
    • 配置adb-mcp-server服务
    • 设置正确的Python路径和环境变量
    • 建立配置验证机制
  • 配置详情:
    • 服务名称: adb-mcp-server
    • Python解释器: /home/lsl/10Dev/20Python/30Venv/.mcp_server_adb/bin/python
    • 服务器脚本: /mnt/hgfs/11WorkSpace/mcp_server_adb/src/server.py
    • 工作目录: /mnt/hgfs/11WorkSpace/mcp_server_adb
    • 环境变量: PYTHONPATH=/mnt/hgfs/11WorkSpace/mcp_server_adb/src
  • 验证结果:
    • ✅ MCP配置文件存在且正确
    • ✅ Python解释器路径有效
    • ✅ 服务器脚本存在
    • ✅ 虚拟环境和项目目录正常
  • 备注: Cursor MCP配置完成，可以重启MCP服务并开始使用ADB功能

[2024-12-19] - MCP服务器功能测试完成

  • 新增功能: 完成MCP服务器功能测试和验证
  • 新增文件:
    • test_mcp_tools.py - MCP工具功能直接测试脚本
    • test_mcp_client.py - MCP客户端测试脚本
    • mcp_config.json - MCP服务器配置文件
  • 技术改进:
    • 修复MCP服务器导入问题
    • 简化MCP服务器实现
    • 实现完整的MCP工具注册和调用机制
    • 建立MCP协议通信测试框架
  • 测试结果:
    • ✅ list_devices 功能正常 - 成功获取设备列表
    • ✅ get_device_info 功能正常 - 成功获取设备详细信息
    • ✅ check_device_status 功能正常 - 成功检查设备状态
    • ✅ 所有MCP工具功能验证通过
  • 功能验证:
    • 设备列表获取：找到1个设备 (172.21.76.174:5555)
    • 设备信息获取：制造商OnePlus，型号KB2000，Android 11
    • 设备状态检查：设备在线状态正常
  • 备注: MCP服务器核心功能测试完成，可以集成到Cursor等MCP客户端使用

[2024-12-19] - 核心基础组件实现

  • 新增功能: 实现ADB MCP服务器核心基础组件
  • 新增文件:
    • requirements.txt - 项目依赖包配置
    • src/config/settings.py - 基础配置管理
    • src/adb/client.py - ADB客户端核心类
    • src/handlers/device_handlers.py - 设备请求处理器
    • src/server.py - MCP服务器主入口
    • main.py - 项目启动脚本
  • 技术改进:
    • 实现ADB命令执行封装
    • 实现设备列表查看功能
    • 实现设备信息获取功能
    • 实现设备状态检查功能
    • 建立MCP协议通信框架
  • 功能特性:
    • 支持列出连接的Android设备
    • 支持获取设备详细信息
    • 支持检查设备连接状态
    • 自动检测ADB路径配置
    • 基础错误处理和超时机制
  • 备注: 核心基础组件实现完成，可以进行设备查看功能测试

[2024-12-19] - 项目初始化

  • 新增功能: 创建项目基础结构
  • 新增文件:
    • .cursorignore - Cursor 编辑器忽略文件配置
    • .cursor/rules/rules.mdc - 项目规则配置
    • README.md - 项目说明文档
  • 技术改进: 建立项目维护规则，确保每次会话后自动更新文档
  • 备注: 项目初始化完成，准备开始开发

[2024-12-19] - Cursor 规则生成

  • 新增功能: 生成完整的 Cursor 开发规则体系
  • 新增文件:
    • .cursor/rules/project-structure.mdc - 项目结构指南
    • .cursor/rules/coding-standards.mdc - 编码标准规范
    • .cursor/rules/adb-development.mdc - ADB 开发特定规范
    • .cursor/rules/testing-guidelines.mdc - 测试编写指南
  • 技术改进:
    • 建立完整的项目结构规范
    • 定义 Python 和 TypeScript 编码标准
    • 提供 ADB 开发最佳实践和代码模板
    • 制定详细的测试编写指南和覆盖率要求
  • 问题修复: 完善项目开发规范，提高代码质量和可维护性
  • 备注: 项目开发规范体系建立完成，为后续开发提供标准化指导

[2024-12-19] - 提示词模版规则创建

  • 新增功能: 创建完整的提示词模版规则体系
  • 新增文件:
    • .cursor/rules/prompt-template.mdc - 提示词模版规则
  • 技术改进:
    • 定义标准提示词模版（功能开发、代码审查、问题诊断等）
    • 提供 ADB 特定模版（命令开发、设备自动化）
    • 包含最佳实践和常见错误避免指南
    • 建立迭代优化策略和使用指南
  • 功能特性:
    • 5个标准提示词模版覆盖常见开发场景
    • 2个 ADB 特定模版针对项目需求
    • 3个特殊场景模版处理紧急情况
    • 详细的最佳实践和优化技巧
  • 备注: 提示词模版规则创建完成，提高与 AI 助手交互效率

开发规范

代码规范

  • 使用中文注释和文档
  • 遵循项目命名规范
  • 保持代码简洁清晰

文档维护

  • 每次会话完成后自动更新 README.md
  • 详细记录功能变更和文件修改
  • 保持文档与实际代码同步

使用说明

环境要求

  • Python 3.8+
  • ADB工具已安装并配置到PATH环境变量
  • Android设备已连接并启用USB调试

安装依赖

pip install -r requirements.txt

启动服务器

python main.py

可用功能

  1. list_devices - 列出连接的Android设备
  2. get_device_info - 获取指定设备的详细信息
  3. check_device_status - 检查设备连接状态

在Cursor中使用

  1. 配置已完成 - MCP服务器已配置到Cursor中
  2. 重启MCP服务 - 在Cursor中重启MCP服务以加载新配置
  3. 测试ADB功能 - 现在可以在Cursor中使用以下ADB功能：
    • list_devices - 列出连接的Android设备
    • get_device_info - 获取设备详细信息
    • check_device_status - 检查设备连接状态

配置验证

运行配置验证脚本：

python verify_cursor_config.py

手动测试

如果需要在Cursor外测试，可以运行：

# 激活虚拟环境
source /home/lsl/10Dev/20Python/30Venv/.mcp_server_adb/bin/activate

# 测试MCP工具功能
python test_mcp_tools.py

# 测试基础ADB功能
python test_basic.py

贡献指南

待补充...

许可证

待补充...