Weixin Bot Qwen MCP

微信机器人 + QwenCode + MCP Server

使用 Qwen-Code 和微信对接的智能助手服务。

🎉 企业微信

如需企业微信的版本，看这里 https://github.com/HammCn/WecomBot-QwenCode

📋 功能特性

• 💚 微信消息接收（文本、图片）
• 🤖 QwenCode 命令执行
• 🔌 MCP Server 支持
• 📁 文件发送工具
• 🔄 会话管理
• 📝 状态持久化

🚀 快速开始

1. 安装依赖

npm install

2. 配置环境变量

复制 .env.example 为 .env 并修改配置：

cp .env.example .env

编辑 .env 文件：

# 微信协议配置（一般无需修改）
WEIXIN_BASE_URL=https://ilinkai.weixin.qq.com
WEIXIN_CDN_BASE_URL=https://novac2c.cdn.weixin.qq.com/c2c
WEIXIN_BOT_TYPE=3
WEIXIN_STATE_FILE=./weixin-bot-state.json

# QwenCode 配置（根据实际路径修改）
QWEN_PATH=/Users/hamm/qwen
WORKSPACE=/Users/hamm/Desktop

# MCP Server 配置
MCP_PORT=12580

3. 启动服务

npm start

4. 微信登录

服务启动后会自动显示二维码：

1. 终端会输出二维码 URL
2. 使用微信扫描二维码
3. 确认登录
4. 登录成功后状态会保存到 weixin-bot-state.json

5. 使用方式

在微信中发送消息给机器人：

• 文本消息：直接发送文本，机器人会调用 QwenCode 执行
• 图片消息：发送图片，机器人会保存并调用 QwenCode 处理
• 命令：发送 /clear 清理会话缓存

🔧 MCP 工具

sendFileToWeixinBot

发送文件到微信用户。

参数：

• path: 文件路径（绝对路径或相对路径）
• userId: 接收文件的微信 ID

示例：

// 在 MCP 客户端中调用
{
  "name": "sendFileToWeixinBot",
  "arguments": {
    "path": "/path/to/file.pdf",
    "userId": "wx_user_id"
  }
}

📊 架构说明

微信消息 → 微信协议客户端 → 消息类型判断 → 对应处理器
                                       │
                                       ├── 文本 → executeQwenCommand
                                       └── 图片 → 保存 → executeQwenCommand

MCP 请求 → HTTP Server → 会话管理 → MCP Server → 工具调用
                                          │
                                          └── sendFileToWeixinBot → 发送文件到微信

🔐 状态管理

登录状态保存在 weixin-bot-state.json：

{
  "accountId": "机器人 ID",
  "userId": "用户 ID",
  "baseUrl": "API 基础 URL",
  "token": "认证 Token",
  "getUpdatesBuf": "轮询缓冲",
  "contextTokens": {
    "微信 ID": "上下文 Token"
  }
}

⚙️ 环境变量

📝 与原项目对比

🐛 故障排查

二维码不显示

检查网络是否正常，确认能访问 ilinkai.weixin.qq.com

登录状态丢失

检查 weixin-bot-state.json 是否存在且可写

消息不响应

1. 检查 token 是否有效
2. 检查 context_token 是否已获取
3. 查看日志输出

MCP 连接失败

1. 确认端口 12580 未被占用
2. 检查防火墙设置
3. 查看 HTTP 服务器日志

📄 License

MIT