# mcp_server_adb

**Repository Path**: lslshadow/mcp_server_adb

## Basic Information

- **Project Name**: mcp_server_adb
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-05
- **Last Updated**: 2025-09-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 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调试

### 安装依赖
```bash
pip install -r requirements.txt
```

### 启动服务器
```bash
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` - 检查设备连接状态

### 配置验证

运行配置验证脚本：
```bash
python verify_cursor_config.py
```

### 手动测试

如果需要在Cursor外测试，可以运行：
```bash
# 激活虚拟环境
source /home/lsl/10Dev/20Python/30Venv/.mcp_server_adb/bin/activate

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

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

## 贡献指南

待补充...

## 许可证

待补充...