WeChat MCP Server
by 1052666
README.md
# WeChat MCP Server
<div align="center">
**一个符合 Model Context Protocol (MCP) 标准的微信消息发送服务器，专为AI助手设计**
[快速开始](#-安装和配置) • [功能特点](#-功能特点) • [使用方法](#-使用方法) • [API文档](#️-可用工具) • [贡献指南](#-贡献)
</div>
---
## 📋 目录
- [什么是 MCP？](#-什么是-mcp)
- [功能特点](#-功能特点)
- [项目结构](#-项目结构)
- [安装和配置](#-安装和配置)
- [可用工具](#️-可用工具)
- [使用方法](#-使用方法)
- [自动化任务与消息报备](#-自动化任务与消息报备)
- [MCP协议实现](#-mcp协议实现)
- [技术架构](#️-技术架构)
- [注意事项](#️-注意事项)
- [故障排除](#-故障排除)
- [开发和扩展](#-开发和扩展)
- [支持我们](#-支持我们)
- [免责声明](#️-重要免责声明)
- [许可证](#-许可证)
- [贡献](#-贡献)
- [项目统计](#-项目统计)
---
## 🤖 什么是 MCP？
> **Model Context Protocol (MCP)** 是一个开放标准协议，用于连接AI助手与各种数据源和工具。它就像是AI应用的USB-C接口，提供了标准化的方式来连接AI模型与外部系统。
## 💻 兼容性
- ✅ **微信版本** - 完全支持微信4.0以上的NT框架版本和传统微信版本
- ✅ **操作系统** - 支持Windows 10/11系统
- ✅ **AI助手** - 兼容Claude、ChatGPT等支持MCP协议的AI助手
## ✨ 功能特点
- ✅ **MCP标准兼容** - 完全符合 MCP 标准规范
- ✅ **JSON-RPC 2.0** - 基于标准的 JSON-RPC 2.0 协议
- ✅ **微信消息发送** - 支持发送微信文本消息
- ✅ **定时发送** - 支持定时发送消息功能
- ✅ **全面版本支持** - 完全支持微信4.0以上的NT框架版本和传统微信版本
- ✅ **智能版本检测** - 自动检测微信版本并适配相应的操作方式
- ✅ **智能输入框定位** - 自适应不同窗口大小和布局的输入框位置
- ✅ **剪贴板输入技术** - 使用剪贴板输入，完全避免输入法状态影响
- ✅ **多种发送方式** - 支持Enter、Ctrl+Enter、Alt+S等多种发送快捷键
- ✅ **异步处理** - 异步处理，不阻塞AI助手
- ✅ **完整日志** - 完整的错误处理和日志记录
- ✅ **部分文本支持** - 目前支持发送英文、数字、表情符号等，暂不支持中文消息发送（可能导致乱码）
## 📁 项目结构
```
WeChat-MCP-Server/
├── 📂 src/
│ ├── 📄 __init__.py
│ ├── 📄 mcp_server.py # MCP服务器主要实现
│ └── 📄 wechat_controller.py # 微信自动化控制器
├── 📂 examples/
│ └── 📄 mcp_client_example.py # 客户端使用示例
├── 📂 docs/
│ └── 📄 QUICK_START.md # 快速开始指南
├── 📂 支持我们/
│ ├── 🖼️ 1.jpg # 支付宝收款码
│ └── 🖼️ 2.jpg # 微信赞赏码
├── 📄 mcp_config.json # MCP配置文件
├── 📄 requirements.txt # 依赖包列表
├── 📄 LICENSE # 许可证文件
└── 📄 README.md # 项目说明文档
```
## 🚀 安装和配置
### 1️⃣ 安装依赖
```bash
# 克隆项目
git clone https://github.com/1052666/WeChat-MCP-Server.git
cd WeChat-MCP-Server
# 安装依赖
pip install -r requirements.txt
```
### 2️⃣ 确保微信已启动并登录
> ⚠️ **重要提醒**
>
> 在使用前，请确保：
> - ✅ 微信客户端已安装并正在运行
> - ✅ 已成功登录微信账号
> - ✅ 微信窗口可见（不要最小化）
### 3️⃣ 配置AI助手
将此MCP服务器添加到您的AI助手配置中。以 **Claude Desktop** 为例：
```json
{
"mcpServers": {
"wechat": {
"command": "python",
"args": ["C:/path/to/WeChat-MCP-Server/src/mcp_server.py"],
"env": {}
}
}
}
```
> **注意**: 请将 `C:/path/to/WeChat-MCP-Server` 替换为您实际的项目路径
## 🛠️ 可用工具
### 📤 send_wechat_message
发送文本消息到指定的微信联系人或群组。
**参数：**
| 参数名 | 类型 | 必填 | 描述 |
|--------|------|------|------|
| `contact_name` | `string` | ✅ | 联系人或群组名称 |
| `message` | `string` | ✅ | 要发送的文本消息 |
**示例：**
```json
{
"name": "send_wechat_message",
"arguments": {
"contact_name": "文件传输助手",
"message": "Hello from AI assistant!"
}
}
```
### ⏰ schedule_wechat_message
安排在指定延迟后发送消息。
**参数：**
| 参数名 | 类型 | 必填 | 描述 |
|--------|------|------|------|
| `contact_name` | `string` | ✅ | 联系人或群组名称 |
| `message` | `string` | ✅ | 要发送的文本消息 |
| `delay_seconds` | `number` | ✅ | 延迟发送的秒数 |
**示例：**
```json
{
"name": "schedule_wechat_message",
"arguments": {
"contact_name": "文件传输助手",
"message": "This is a scheduled message!",
"delay_seconds": 30
}
}
```
## 💡 使用方法
### 🤖 在AI助手中使用
配置完成后，您可以直接在AI助手中使用自然语言请求：
> 💬 **示例对话**
>
> - "帮我给张三发个微信消息说'会议推迟到下午3点'"
> - "10分钟后提醒我开会，发到工作群"
> - "给文件传输助手发送今天的工作总结"
### 🧪 直接测试
运行示例客户端进行测试：
## 🔄 自动化任务与消息报备
### 🚀 使用Cloud Code自动化工作流
试想一下，您可以使用Cloud Code等自动化工具完成各种任务，并通过微信自动发送报备消息：
#### 📊 自动化场景示例
1. **代码部署通知**
- 当CI/CD流程完成时，自动向开发团队群发送部署状态
- 包含构建结果、测试覆盖率和部署环境信息
2. **监控报警集成**
- 将服务器监控报警直接推送到运维群
- 系统负载、异常状态实时通知到责任人
3. **数据处理完成通知**
- 大型数据处理任务完成后自动通知数据分析师
- 包含处理时间、数据量和结果摘要
4. **定时报表推送**
- 每日/每周自动生成业务报表并发送给管理层
- 销售数据、用户增长等关键指标自动汇总
#### 💻 实现示例
```python
# 示例：GitHub Actions完成后发送微信通知
import requests
def send_deployment_notification(status, details):
# 调用WeChat MCP Server API
payload = {
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "send_wechat_message",
"arguments": {
"contact_name": "技术团队群",
"message": f"🚀 部署状态: {status}\n📋 详情: {details}"
}
}
}
response = requests.post("http://localhost:8080/mcp", json=payload)
return response.json()
# 在CI/CD流程中调用
if __name__ == "__main__":
send_deployment_notification("成功", "版本v2.1.0已部署到生产环境")
```
```bash
cd examples
python mcp_client_example.py
```
## 🔧 MCP协议实现
本服务器实现了以下MCP标准方法：
| 方法 | 描述 |
|------|------|
| `initialize` | 初始化服务器连接 |
| `tools/list` | 列出可用工具 |
| `tools/call` | 调用指定工具 |
### 📡 JSON-RPC 消息格式
<details>
<summary>点击查看详细的消息格式示例</summary>
**请求示例：**
```json
{
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "send_wechat_message",
"arguments": {
"contact_name": "文件传输助手",
"message": "Hello World!"
}
},
"id": 1
}
```
**响应示例：**
```json
{
"jsonrpc": "2.0",
"result": {
"content": [
{
"type": "text",
"text": "Successfully sent message to 文件传输助手: Hello World!"
}
]
},
"id": 1
}
```
</details>
## 🏗️ 技术架构
### 🖥️ MCP服务器 (mcp_server.py)
- 实现JSON-RPC 2.0协议
- 处理MCP标准方法调用
- 管理工具注册和执行
- 提供完整的错误处理
### 📱 微信控制器 (wechat_controller.py)
- 使用pyautogui进行界面自动化
- 使用win32gui查找和控制微信窗口
- **🆕 NT框架支持**: 完全支持微信4.0及以上版本
- **🔍 智能版本检测**: 自动检测微信版本并适配操作方式
- **🎯 多窗口类型识别**: 支持QT框架和传统窗口类型
- 支持异步消息发送和调度
- 提供状态检查功能
#### 🔧 NT框架技术特性
- **版本检测**: 通过进程信息自动检测微信版本
- **窗口识别**: 支持QT框架窗口类名模式匹配
- **操作适配**: 针对NT框架优化的搜索和发送逻辑
- **兼容性**: 向下兼容传统微信版本（<4.0）
#### 🎯 智能输入技术
- **智能定位**: 自适应不同窗口大小的输入框位置检测
- **剪贴板输入**: 使用Windows剪贴板API实现文本输入，完全避免输入法干扰
- **焦点验证**: 通过测试字符输入验证输入框焦点状态
- **剪贴板保护**: 自动备份和恢复用户原始剪贴板内容
- **多重发送**: 支持Enter、Ctrl+Enter、Alt+S等多种发送快捷键备选方案
## ⚠️ 注意事项
### 🖥️ 系统要求
- **操作系统**: Windows 系统
- **微信版本**: 微信客户端（支持所有版本，包括4.0及以上NT框架版本）
- **Python版本**: Python 3.8+
### 🔐 权限要求
- 需要屏幕控制权限（pyautogui）
### 📝 使用限制
> ⚠️ **重要提醒**
>
> - 使用期间请勿手动操作微信窗口
> - 确保微信窗口可见且未被遮挡
> - 建议先向"文件传输助手"测试
### 🛡️ 安全考虑
- 本工具仅用于自动化个人微信操作
- 请遵守微信使用条款
- 不建议用于大量消息发送
## 🔍 故障排除
<details>
<summary>📋 常见问题解决方案</summary>
### ❌ 找不到微信窗口
- ✅ 确保微信已启动并登录
- ✅ 检查微信窗口是否可见
- ✅ 尝试重启微信
### ❌ 消息发送失败
- ✅ 检查联系人名称是否正确
- ✅ 确保联系人在最近聊天列表中
- ✅ 验证微信窗口是否处于活动状态
### ❌ 输入法相关问题
- ✅ **已解决**: 本项目使用剪贴板输入技术，完全避免输入法状态影响
- ✅ 支持任何输入法状态下的中文、英文、表情符号输入
- ✅ 自动保护用户剪贴板内容，使用后自动恢复
### ❌ 输入框定位失败
- ✅ **已优化**: 智能输入框定位系统自适应不同窗口大小
- ✅ 支持多种微信界面布局和分辨率
- ✅ 自动尝试多个可能的输入框位置
### ❌ MCP连接问题
- ✅ 检查Python环境和依赖包
- ✅ 验证MCP配置文件路径
- ✅ 查看服务器日志输出
</details>
### 📊 日志调试
服务器会输出详细的日志信息，包括：
- ✅ 请求处理状态
- ✅ 微信操作结果
- ✅ 错误信息和堆栈跟踪
## 🚧 开发和扩展
### ➕ 添加新工具
1. 在 `mcp_server.py` 中的 `_register_tools()` 方法添加工具定义
2. 实现对应的执行方法
3. 在 `wechat_controller.py` 中添加具体功能
4. 更新配置文件和文档
### 🌐 支持其他平台
当前版本仅支持Windows系统。要支持其他平台，需要：
- 替换win32gui相关代码
- 适配不同系统的窗口管理
- 调整键盘快捷键映射
### 🗺️ 后续开发计划
- [x] ~~智能输入框定位~~ ✅ **已完成**
- [x] ~~剪贴板输入技术~~ ✅ **已完成**
- [x] ~~多种发送方式支持~~ ✅ **已完成**
- [x] ~~输入法兼容性问题~~ ✅ **已完成**
- [ ] 支持macOS和Linux系统
- [ ] 增加更多微信操作功能（如发送图片、文件等）
## 💖 支持我们
如果您觉得这个项目对您有帮助，请考虑：
- ⭐ 给项目点个Star
- 🔄 分享给您的朋友
- 💰 考虑捐赠以支持项目维护和发展
### 💳 捐赠方式
如果您愿意支持项目的持续发展，可以通过以下方式进行捐赠：
<div align="center">
**支付宝收款码**
<img src="支持我们/1.jpg" alt="支付宝收款码" width="200"/>
**微信赞赏码**
<img src="支持我们/2.jpg" alt="微信赞赏码" width="200"/>
</div>
您的每一份支持都是我们持续改进和维护项目的动力！❤️
---
## ⚠️ 重要免责声明
> **🚨 严重警告**
>
> 本项目涉及微信自动化操作，存在重大风险。使用前请充分评估风险并自行承担所有后果。
<details>
<summary>📋 点击查看完整免责声明</summary>
### 🏷️ 项目性质声明
1. **纯技术研究**: 本项目仅为技术研究和学习目的而创建，用于演示MCP协议的实现
2. **非官方工具**: 本项目与腾讯公司、微信官方无任何关联，未经微信官方授权或认可
3. **实验性质**: 本项目为实验性代码，不保证稳定性、安全性或可靠性
### ⚠️ 使用风险警告
1. **账号风险**: 使用任何微信自动化工具都可能导致账号被限制、封禁或永久注销
2. **数据风险**: 可能导致聊天记录丢失、联系人信息泄露或其他数据安全问题
3. **系统风险**: 可能对您的计算机系统造成不稳定或安全漏洞
4. **法律风险**: 在某些地区或情况下，使用此类工具可能违反相关法律法规
5. **隐私风险**: 可能涉及个人隐私信息的处理和传输
### 📱 微信相关免责
1. **违反服务条款**: 使用本项目可能违反微信用户服务协议和使用条款
2. **功能失效**: 微信更新可能随时导致本项目功能完全失效
3. **官方制裁**: 腾讯公司有权对使用自动化工具的账号采取任何措施
4. **无官方支持**: 微信官方不会为使用本项目产生的任何问题提供技术支持
### 🔴 完全免责条款
**开发者、贡献者、分发者在任何情况下均不承担任何责任，包括但不限于：**
#### 直接责任免除
- 微信账号被封禁、限制或注销
- 个人数据丢失、泄露或被滥用
- 计算机系统损坏或数据损坏
- 消息发送错误或失败
- 隐私信息泄露
- 经济损失或商业损失
#### 间接责任免除
- 因使用本项目导致的任何第三方损失
- 因项目缺陷导致的连带损失
- 因违反法律法规产生的法律后果
- 因违反平台规则产生的处罚
- 任何形式的精神损失或名誉损失
#### 法律责任免除
- 违反当地法律法规的责任
- 违反微信服务条款的责任
- 侵犯他人权益的责任
- 数据保护法规违规的责任
- 任何民事、刑事或行政责任
### 📋 使用条件
**使用本项目即表示您：**
1. 已完全理解并接受上述所有风险和免责条款
2. 同意自行承担使用本项目的所有风险和后果
3. 承诺不会因使用本项目产生的任何问题追究开发者责任
4. 理解开发者有权随时停止项目维护而无需承担任何责任
5. 同意在发生任何争议时，开发者均不承担任何责任
### ⛔ 禁止使用声明
**以下情况严禁使用本项目：**
- 批量发送广告或垃圾信息
- 骚扰他人或恶意使用
- 违反当地法律法规的用途
- 侵犯他人权益的行为
- 违反微信服务条款的行为
### 💼 商业使用警告
**虽然MIT许可证允许商业使用，但我们强烈建议：**
- 商业使用前请充分评估法律风险
- 确保遵守所在地区的相关法律法规
- 遵守微信平台的商业使用政策
- 建议咨询法律专业人士的意见
- 商业使用产生的所有风险由使用者自行承担
**如果您不同意上述任何条款，请立即停止下载、安装或使用本项目。继续使用即视为完全同意并接受所有免责条款。**
</details>
---
## 📄 许可证
本项目采用 **MIT License** 开源许可证。
<details>
<summary>📋 许可证详情</summary>
MIT许可证允许：
- ✅ **商业使用** (⚠️ 需评估风险)
- ✅ 修改代码
- ✅ 分发代码
- ✅ 私人使用
但需要：
- 📋 保留版权声明
- 📋 保留许可证声明
**重要提醒**:
- ✅ MIT许可证在法律上允许商业使用
- ⚠️ 但商业使用微信自动化工具存在较高风险
- 🔍 建议商业使用前咨询法律专业人士
- 📋 所有商业使用风险由使用者自行承担
</details>
## 🤝 贡献
我们欢迎所有形式的贡献！
### 🐛 报告问题
- 使用 [Issues](https://github.com/1052666/WeChat-MCP-Server/issues) 报告bug
- 提供详细的错误信息和复现步骤
## 📞 联系我们
如果您有任何问题、建议或合作意向，欢迎通过以下方式联系我们：
- **微信号**: 13115979196
- **GitHub**: [提交Issue](https://github.com/1052666/WeChat-MCP-Server/issues)
我们会尽快回复您的咨询！
### 💡 功能建议
- 在 [Issues](https://github.com/1052666/WeChat-MCP-Server/issues) 中提出新功能建议
- 详细描述功能需求和使用场景
### 🔧 代码贡献
1. Fork 本项目
2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 创建 Pull Request
---
## 📈 项目统计
### ⭐ Star 增长趋势
<div align="center">
[](https://star-history.com/#1052666/WeChat-MCP-Server&Date)
</div>
### 📊 项目数据
<div align="center">
</div>
---
<div align="center">
**感谢您使用 WeChat MCP Server！**
如果这个项目对您有帮助，请考虑给我们一个 ⭐
[回到顶部](#weChat-mcp-server)
</div>
This server cannot be deployed
Maintenance
ActivityInactive
ResponsivenessUnresponsive