mcp-wechat-server

mcp-wechat-server is an MCP (Model Context Protocol) server that enables AI agents to perform a WeChat bot flow:扫码登录、查询登录状态、长轮询获取新消息、发送文本消息，并通过打字状态工具向对方显示“正在输入...”。它还在本地持久化登录凭证与消息游标以便重启后继续运行。

Evaluated Mar 30, 2026 (0d ago)
Repo ↗ Communication mcp wechat weixin bot messaging agent-integration bun typescript
⚙ Agent Friendliness
45
/ 100
Can an agent use this?
🔒 Security
29
/ 100
Is it safe for agents?
⚡ Reliability
30
/ 100
Does it work consistently?

Score Breakdown

⚙ Agent Friendliness

MCP Quality
70
Documentation
55
Error Messages
0
Auth Simplicity
65
Rate Limits
5

🔒 Security

TLS Enforcement
20
Auth Strength
35
Scope Granularity
10
Dep. Hygiene
55
Secret Handling
30

README明确会将 account.json（权限 600）与 state.json、二维码等写入本地目录。虽然本地文件权限较好信号，但未说明是否对敏感字段做加密、是否避免日志泄露、以及在多用户/共享环境中的安全措施。未提供网络传输安全细节（是否强制 HTTPS/TLS）与错误/日志脱敏策略；且缺少细粒度权限范围与权限模型描述。

⚡ Reliability

Uptime/SLA
0
Version Stability
45
Breaking Changes
50
Error Recovery
25
AF Security Reliability

Best When

你已经有一个支持 MCP 的客户端（如 Claude Desktop / Cursor / OpenCode 等），并且愿意在本机用 Bun 运行该 MCP 服务，通过扫码完成一次性登录后持续轮询与回复。

Avoid When

你不能接受本地持久化凭证与状态文件（account.json/state.json）带来的安全风险，或你需要清晰的公开 API 规范（如 OpenAPI）与强可观测性/错误恢复机制。

Use Cases

  • • 让本地/桌面 MCP 客户端实现微信收发消息
  • • 构建“AI 代聊”型微信机器人（接收消息并回复）
  • • 需要与任意 MCP Agent 对接的微信消息网关

Not For

  • • 不具备本地运行能力或不希望保存任何本地凭证的场景
  • • 需要企业级合规审计、集中式密钥托管或托管服务 SLA 的场景
  • • 对微信登录稳定性要求极高、无法进行人工扫码的场景

Interface

REST API
No
GraphQL
No
gRPC
No
MCP Server
Yes
SDK
No
Webhooks
No

Authentication

Methods: 扫码登录（生成二维码后由用户在微信端确认） 登录后会在本地持久化凭证（account.json）
OAuth: No Scopes: No

鉴权/会话主要依赖微信扫码登录后得到的本地凭证与消息游标持久化；README未提及OAuth/细粒度权限范围。

Pricing

Free tier: No
Requires CC: No

README未提供定价信息；从描述看为本地运行的开源/包服务。

Agent Metadata

Pagination
none
Idempotent
False
Retry Guidance
Not documented

Known Gotchas

  • ⚠ 登录流程需要人工扫码确认；首次使用可能阻塞等待状态变更
  • ⚠ get_messages 使用长轮询（wait=true），需要让 Agent 处理阻塞式调用与超时/最大等待时间（最长约 7 天）
  • ⚠ 二维码在本地生成并保存（qrcode.txt/qrcode.png）；Agent 侧可能需要处理展示/读取二维码的方式
  • ⚠ 本地状态/游标持久化依赖目录（~/.mcp-wechat-server/）；并发运行或异常退出可能导致状态不一致（README未明确最佳实践）

Alternatives

直接使用第三方微信机器人 SDK/HTTP API（非 MCP）并在代理层完成桥接 使用通用消息总线/机器人平台（如果需要企业级托管）再对接 MCP 在 MCP 生态中选用已有“更成熟的微信/IM 网关”实现（若存在）

Full Evaluation Report

Comprehensive deep-dive: security analysis, reliability audit, agent experience review, cost modeling, competitive positioning, and improvement roadmap for mcp-wechat-server.

AI-powered analysis · PDF + markdown · Delivered within 30 minutes

$99

Package Brief

Quick verdict, integration guide, cost projections, gotchas with workarounds, and alternatives comparison.

Delivered within 10 minutes

$3

Score Monitoring

Get alerted when this package's AF, security, or reliability scores change significantly. Stay ahead of regressions.

Continuous monitoring

$3/mo
API endpoint ↗ Agent guide ↗ Report inaccuracy

Scores are editorial opinions as of 2026-03-30.

6533
Packages Evaluated
19870
Need Evaluation
586
Need Re-evaluation
♥
Community Powered