About Wechat Server
Wechat Server is an MCP server published by Howardzhangdqs in the Developer Tools category: enables AI applications to send and read WeChat messages on Windows PCs through QR code authentication. Provides message polling, text sending, and session persistence for AI-powered chat interactions.
The repository has 113 stars and 23 forks, with the last commit 7 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
git clone https://github.com/Howardzhangdqs/mcp-wechat-serverThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (5)
check_qrcode_statusCheck if the QR code (from login_qrcode) has been scanned and confirmed. Call this repeatedly until status is
Parameters not published.
login_qrcodeGet a WeChat login QR code. Scan it with WeChat to connect the bot. Returns the QR code URL. Call check_qrcode_status afterwards to verify.
Parameters not published.
logoutLog out the current WeChat bot session and clear all saved credentials.
Parameters not published.
send_text_messageSend a text message to a WeChat user. The
Parameters not published.
send_typingSend or cancel a typing indicator to a WeChat user. The
Parameters not published.
Ask AI
Ask AI about Wechat Server
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
mcp-wechat-server
基于 MCP（Model Context Protocol）的微信机器人服务器，让任何 AI Agent 都能收发微信消息。
功能
- 6 个 MCP 工具：登录、消息轮询、文本发送、打字状态
- 扫码登录：生成终端文本二维码、PNG 图片、URL 链接三种方式
- 长轮询监听：阻塞等待新消息，最长可等待 7 天
- 打字状态：Agent 处理消息时自动显示"对方正在输入..."
- 状态持久化：重启不丢失登录凭证和消息游标
- 独立运行：无需 OpenClaw 框架，开箱即用
快速开始
Claude Desktop
在 claude_desktop_config.json 中添加：
{
"mcpServers": {
"wechat": {
"command": "bunx",
"args": ["mcp-wechat-server"]
}
}
}
OpenCode
在 opencode.json 中添加：
{
"mcp": {
"wechat": {
"type": "local",
"command": ["bunx", "mcp-wechat-server"],
"enabled": true
}
}
}
Cursor / 其他 MCP 客户端
{
"command": "bunx",
"args": ["mcp-wechat-server"]
}
bunx会自动从 npm 下载并运行，无需手动安装。
环境要求
- Bun >= 1.0.0
使用方法
1. 扫码登录
AI Agent 调用 login_qrcode 生成二维码，你可以通过以下方式扫码：
- 在终端运行
cat ~/.mcp-wechat-server/qrcode.txt查看二维码 - 打开图片文件
~/.mcp-wechat-server/qrcode.png - 将链接复制到微信中打开
提示：如果手机扫码后页面一直加载，请切换到移动数据网络（关闭 WiFi）。
2. 确认登录
Agent 调用 check_qrcode_status 确认登录状态。
3. 开始聊天
登录成功后，Agent 会自动执行以下流程：
- 调用
get_messages轮询新消息 - 收到消息后调用
send_typing显示"正在输入..." - 处理完成后调用
send_text_message回复 - 回复完毕后调用
send_typing取消打字状态
工具列表
| 工具 | 说明 |
|---|---|
login_qrcode |
生成微信登录二维码 |
check_qrcode_status |
检查二维码是否已扫码确认 |
logout |
退出登录并清除凭证 |
get_messages |
拉取新消息（wait=true 阻塞等待直到收到消息） |
send_text_message |
发送文本消息 |
send_typing |
发送或取消"正在输入"状态 |
数据存储
所有数据保存在 ~/.mcp-wechat-server/ 目录下：
| 文件 | 说明 |
|---|---|
account.json |
Bot Token 和用户 ID（权限 600） |
state.json |
消息游标和上下文 Token |
qrcode.png |
生成的二维码图片 |
qrcode.txt |
生成的终端二维码文本 |
本地开发
git clone https://github.com/Howardzhangdqs/mcp-wechat-server.git
cd mcp-wechat-server
bun install
bun run dev
许可证
MIT
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.