# MCP WeChat ADB Server

一个基于 ADB 的微信自动化 MCP 服务器，为 AI 助手提供微信消息发送和截图功能，可以实现 AI 自动对多个联系人微信回复不同的个性化消息，满足商务生活需求。适配雷电模拟器（LDPlayer 9），通过 MCP 协议暴露工具接口。蓝耘MCP开发挑战赛作品，MCP入口文件是 main.py

## 🚀 功能特性

- **微信消息发送**：通过自然语言指令发送微信消息
- **智能截图**：自动截图并保存到本地
- **MCP 协议支持**：与 Cursor、Claude Desktop 等支持 MCP 的 AI 助手无缝集成
- **雷电模拟器适配**：专为 LDPlayer 9 优化，支持中文输入

## 🛠️ 可用工具

- `send_wechat_message(name, message)` - 发送微信消息
- `screen_save()` - 截图保存

### 环境要求

- Windows 10/11（已测试）
- Python >= 3.13
- 雷电模拟器 LDPlayer 9（已安装并登录微信）
- 已启用 ADB 调试（在模拟器 诊断信息 中可查看 ADB 端口）

### 完整安装配置流程

#### 第一步：安装雷电模拟器
1. 下载并安装雷电模拟器，测试使用的是 9.1.58(64) 官网最新版本，安装路径中不要有空格，并将路径填入 main.py 的 ldplayer_dir 变量中
2. 设置模拟器分辨率为 1600x900
3. 在模拟器中安装微信，模拟器里直接搜索安装的就行，测试用的是 Version 8.0.58
4. 登录微信账号并手动设置好权限
5. 打开微信试用一下，确保不会弹出风险提示，能正常运行（一般微信都没问题）
6. **查看 ADB 端口**：在命令行中执行以下命令查看可用的设备端口：
   ```powershell
   D:\Program\leidian\LDPlayer9\adb.exe devices
   ```
   查看结果示例：
   ```
   List of devices attached
   127.0.0.1:5555  device
   emulator-5554   device
   ```
   选择第一个端口（如 `127.0.0.1:5555`）填入 main.py 的 `DEVICE` 变量

#### 第二步：创建 Python 环境
可以使用 conda 或者 uv 创建环境，推荐使用 Python 3.13：

```powershell
# 使用 conda
conda create -n mcp-wechat python=3.13
conda activate mcp-wechat

# 或使用 uv
uv venv
uv pip install "mcp[cli]"
```

只需要安装 `pip install "mcp[cli]"` 库即可。

#### 第三步：配置和运行
1. 将模拟器目录位置填入 `main.py` 的 `ldplayer_dir` 变量
2. 将第一步查看到的 ADB 设备端口填入 `main.py` 的 `DEVICE` 变量（如 `"127.0.0.1:5555"`）
3. 默认启用 SSE 模式运行，用当前环境下的 Python 运行 `main.py`：
   ```powershell
   python main.py
   ```
运行后会启动 MCP SSE 服务并注册以下工具：

- `send_wechat_message(name: str, message: str) -> str`
  - 功能：给指定联系人发送消息
  - 依赖：微信已登录、ADB 输入法已激活

- `screen_save() -> str`
  - 功能：在模拟器上截图并保存到 `screens/` 目录
    
#### 第四步：配置 Cursor MCP
1. 在 Cursor 中设置：Tools and Integrations → Add Custom MCP
2. 在 `mcp.json` 文件中写入：
   ```json
   {
     "mcpServers": {
       "plus": {
         "url": "http://127.0.0.1:8000/sse"
       }
     }
   }
   ```
3. 开启这个 MCP Tools，显示小绿点以后即可正常在Cursor的 Agent 对话框里对话了

### 重要注意事项

- **ADBKeyboard.apk 文件**：目录下的 `ADBKeyboard.apk` 文件不能少，这个是雷电模拟器的 ADB 输入中文需要的插件
- **截图功能**：截图功能会将截图保存在 `screens` 文件夹下
- **ADB 端口查看**：使用 `{模拟器路径}\adb.exe devices` 命令查看可用的设备端口

### 目录结构

- `main.py`：MCP 服务入口，注册工具并运行 `FastMCP`（SSE 传输）。
- `wechat_example.py`：封装微信相关操作（进入对话、输入、发送等）。
- `adb_utils.py`：ADB 基础能力（连接、点击、输入法激活、截图、分辨率、Activity 检测等）。
- `ADBKeyboard.apk`：通过广播输入文本所需的输入法 APK（首次会自动安装并激活）。
- `screens/`：截图输出目录（自动创建）。

### 使用示例

配置好 MCP 后，您可以在 Cursor 的 Agent 中直接使用以下功能：

#### 发送微信消息
```
给 AAA 说我感冒了，写一个请假条发给他
```

#### 截图功能
```
帮我截图
```

#### 组合使用示例
```
给 AAA、 BBB 发信息说我今晚不回家，分别截图
```
演示视频：

[https://github-production-user-asset-6210df.s3.amazonaws.com/22809627/477622786-0ec32420-ddcc-4d1e-9482-905de7c3cf8f.mp4](https://private-user-images.githubusercontent.com/22809627/477629438-e4108c91-e09b-427f-8179-1bd53feb5c2b.mp4?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NTUxMDAwNjMsIm5iZiI6MTc1NTA5OTc2MywicGF0aCI6Ii8yMjgwOTYyNy80Nzc2Mjk0MzgtZTQxMDhjOTEtZTA5Yi00MjdmLTgxNzktMWJkNTNmZWI1YzJiLm1wND9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNTA4MTMlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjUwODEzVDE1NDI0M1omWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPWZmYTdhN2RiN2ZlZWMyMjcyNmRlMDRjMGRhNTIyNTZlMDRkOTc4YjgwM2Y0MzFhYmU0MmQwZmM2MmRlNTEzZWEmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0In0.g-nHSS69EJpZcRuyeuEOw_5mYgc38pIBS9m7yaD9zN8)

#### 重要提醒：联系人名称
⚠️ **AAA、BBB 需要是微信中联系人或群聊的名字/备注中能搜索到的唯一名称，这样才能根据名字准确找到指定对方并进入对话**

- 可以使用微信**备注** 给需要的人和群聊特殊的备注，以便搜索

### 后续计划

🚀 本项目已实现将 adb 操作完美接入MCP，让AI可以自由操作模拟器，随着多模态大模型的发展进步，后续可以将截图输入给具有图像理解和定位能力的大模型（例如GLM-4.5V），让 AI Agent 通过 MCP 能完全自动化地边看边操作每一步，完成任何手机上的任务。

### 常见问题排查

路径分隔符在 Windows 下建议使用原始字符串或双反斜杠，例如：

```python
ldplayer_install_dir = r"D:\\Program\\leidian\\LDPlayer9"
```

首次运行会自动检查并安装/激活 `ADBKeyboard.apk`，若自动激活失败，可手动执行例如：

```powershell
"D:\Program\leidian\LDPlayer9\adb.exe" -s 127.0.0.1:5555 install -r ADBKeyboard.apk
"D:\Program\leidian\LDPlayer9\adb.exe" -s 127.0.0.1:5555 shell ime enable com.android.adbkeyboard/.AdbIME
"D:\Program\leidian\LDPlayer9\adb.exe" -s 127.0.0.1:5555 shell ime set com.android.adbkeyboard/.AdbIME
```

- 连接失败或超时：
  - 确认 `adb.exe` 路径是否正确，能否执行：
    ```powershell
    "D:\Program\leidian\LDPlayer9\adb.exe" devices  
    "D:\Program\leidian\LDPlayer9\adb.exe" connect 127.0.0.1:5555
    "D:\Program\leidian\LDPlayer9\adb.exe" -s 127.0.0.1:5555 shell screencap -p /sdcard/screen.png
    ```
  - 确认模拟器中 ADB 端口与 `ld_adb_address` 一致。
  - 确认模拟器中 ADB 端口与 `DEVICE` 变量一致。
  - 如果设备列表为空，请检查模拟器是否正常运行，ADB 调试是否已启用。


### 许可

本项目采用 [MIT 许可证](LICENSE)。

**注意事项：**
- 本项目仅用于学习和研究目的
- 使用本工具时请遵守相关法律法规和微信用户协议
- 请勿用于商业用途或恶意用途
- `pyproject.toml` 已通过打包排除规则避免将 `runtime/`、`screens/` 等内容发布到分发包