---
type: library
origin: Wechat Mcp.md
originPath: sources/Wechat Mcp.md
ingested: 2026-05-04
updated: 2026-05-04T05:06:00Z
tags: [wechat, mcp, windows, automation, pyautogui, openclaw-skill, clippings]
sourceUrl: https://clawhub.ai/dragon015/wechat-mcp
versionHash: k973qk758wp37dg4v5ecq40gbs8218j0
securityNote: ClawHub Security 扫描检测到敏感功能，使用前请查看完整扫描结果
---

## 摘要

Wechat Mcp（by Dragon015）是 Windows 平台的微信消息监控与发送 MCP 服务器，基于图像识别（OpenCV）和窗口操作（pygetwindow、pyautogui）实现自动化。安装方式：`openclaw skills install wechat-mcp`。ClawHub Security 已标记敏感功能，使用前请查阅扫描结果。

## 安装

### Python 依赖

```bash
pip install pyautogui pygetwindow pillow pyperclip opencv-python
```

### 安装 MCP 技能

```bash
openclaw skills install wechat-mcp
```

## 核心功能

| 功能 | 说明 |
|------|------|
| 📸 截图 | 获取微信窗口截图 |
| 👤 搜索联系人 | 查找并打开与指定联系人的聊天窗口 |
| ✉️ 发送消息 | 向指定联系人或当前窗口发送文本 |
| 🔍 状态获取 | 查询微信运行状态（窗口位置、尺寸等） |

## API 接口

### Python 编程接口

```python
from server import send_message_to_contact, send_message_to_current, get_wechat_status

# 给指定联系人发消息（完整流程：搜索→打开聊天→发送）
send_message_to_contact("联系人名称", "消息内容")

# 给当前已打开的聊天窗口发消息
send_message_to_current("消息内容")

# 获取微信状态
status = get_wechat_status()
print(status)
# {'status': 'running', 'title': '微信', 'position': {'x': 0, 'y': 0}, 'size': {'width': 1920, 'height': 1080}}
```

### MCP 工具接口

```json
{
  "tools": [
    {
      "name": "wechat_get_status",
      "description": "获取微信窗口状态"
    },
    {
      "name": "wechat_send_message",
      "description": "给当前聊天窗口发送消息",
      "inputSchema": {
        "type": "object",
        "properties": {
          "message": {"type": "string", "description": "消息内容"}
        },
        "required": ["message"]
      }
    }
  ]
}
```

## 发送消息完整流程

底层实现步骤：
1. 根据联系人名称搜索聊天窗口
2. 打开与该联系人的聊天窗口
3. 激活微信窗口（使其获得焦点）
4. 模拟键盘输入文本（通过 pyperclip 粘贴 + pyautogui 输入）
5. 按回车发送

## 注意事项

1. **微信窗口必须保持打开状态**才能操作
2. 发送消息时会自动激活微信窗口
3. **中文输入**：依赖系统中文输入法正常工作；通过剪贴板粘贴方式处理
4. **独立聊天窗口**：支持单独打开的对话窗口（非主窗口列表中的会话）
5. **安全提示**：ClawHub Security 已对该技能发出警告，涉及系统级自动化请谨慎使用

## 文件结构

```
wechat-mcp/
├── server.py          # MCP 服务器主程序
├── test_wechat.py      # 测试工具
├── requirements.txt     # Python 依赖
└── README.md           # 说明文档
```

## 版本信息

当前版本 hash：`k973qk758wp37dg4v5ecq40gbs8218j0`

## 本文件对 wiki 的贡献

- 实体：[[wiki/entities/wechat-mcp|Wechat Mcp]]
- 概念：MCP 协议在 Windows GUI 自动化场景的应用案例
- 生态关联：OpenClaw Skills 在桌面自动化场景的代表工具

## 相关页面

- [[wiki/entities/wechat-mcp|Wechat Mcp（实体）]]
- [[wiki/concepts/mcp|MCP]]
- [[wiki/concepts/openclaw-skills|OpenClaw Skills]]