WeChat MCP Server

📋 目录

• 什么是 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️⃣ 安装依赖

# 克隆项目
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 为例：

{
  "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

发送文本消息到指定的微信联系人或群组。

参数：

示例：

{
  "name": "send_wechat_message",
  "arguments": {
    "contact_name": "文件传输助手",
    "message": "Hello from AI assistant!"
  }
}

⏰ schedule_wechat_message

安排在指定延迟后发送消息。

参数：

示例：

{
  "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. 定时报表推送

   • 每日/每周自动生成业务报表

... View full README on GitHub