{"id":"howardzhangdqs-mcp-wechat-server","name":"mcp-wechat-server","homepage":null,"repo_url":"https://github.com/Howardzhangdqs/mcp-wechat-server","category":"communication","subcategories":[],"tags":["mcp","wechat","weixin","bot","messaging","agent-integration","bun","typescript"],"what_it_does":"mcp-wechat-server is an MCP (Model Context Protocol) server that enables AI agents to perform a WeChat bot flow:扫码登录、查询登录状态、长轮询获取新消息、发送文本消息，并通过打字状态工具向对方显示“正在输入...”。它还在本地持久化登录凭证与消息游标以便重启后继续运行。","use_cases":["让本地/桌面 MCP 客户端实现微信收发消息","构建“AI 代聊”型微信机器人（接收消息并回复）","需要与任意 MCP Agent 对接的微信消息网关"],"not_for":["不具备本地运行能力或不希望保存任何本地凭证的场景","需要企业级合规审计、集中式密钥托管或托管服务 SLA 的场景","对微信登录稳定性要求极高、无法进行人工扫码的场景"],"best_when":"你已经有一个支持 MCP 的客户端（如 Claude Desktop / Cursor / OpenCode 等），并且愿意在本机用 Bun 运行该 MCP 服务，通过扫码完成一次性登录后持续轮询与回复。","avoid_when":"你不能接受本地持久化凭证与状态文件（account.json/state.json）带来的安全风险，或你需要清晰的公开 API 规范（如 OpenAPI）与强可观测性/错误恢复机制。","alternatives":["直接使用第三方微信机器人 SDK/HTTP API（非 MCP）并在代理层完成桥接","使用通用消息总线/机器人平台（如果需要企业级托管）再对接 MCP","在 MCP 生态中选用已有“更成熟的微信/IM 网关”实现（若存在）"],"af_score":44.8,"security_score":29.0,"reliability_score":30.0,"package_type":"mcp_server","discovery_source":["github"],"priority":"high","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-03-30T15:18:08.476864+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":true,"mcp_server_url":null,"has_sdk":false,"sdk_languages":[],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":["扫码登录（生成二维码后由用户在微信端确认）","登录后会在本地持久化凭证（account.json）"],"oauth":false,"scopes":false,"notes":"鉴权/会话主要依赖微信扫码登录后得到的本地凭证与消息游标持久化；README未提及OAuth/细粒度权限范围。"},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"README未提供定价信息；从描述看为本地运行的开源/包服务。"},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":44.8,"security_score":29.0,"reliability_score":30.0,"mcp_server_quality":70.0,"documentation_accuracy":55.0,"error_message_quality":0.0,"error_message_notes":null,"auth_complexity":65.0,"rate_limit_clarity":5.0,"tls_enforcement":20.0,"auth_strength":35.0,"scope_granularity":10.0,"dependency_hygiene":55.0,"secret_handling":30.0,"security_notes":"README明确会将 account.json（权限 600）与 state.json、二维码等写入本地目录。虽然本地文件权限较好信号，但未说明是否对敏感字段做加密、是否避免日志泄露、以及在多用户/共享环境中的安全措施。未提供网络传输安全细节（是否强制 HTTPS/TLS）与错误/日志脱敏策略；且缺少细粒度权限范围与权限模型描述。","uptime_documented":0.0,"version_stability":45.0,"breaking_changes_history":50.0,"error_recovery":25.0,"idempotency_support":"false","idempotency_notes":"README未说明各工具在重复调用时的幂等性策略（例如重复拉取/重复发送的去重与游标推进规则）。","pagination_style":"none","retry_guidance_documented":false,"known_agent_gotchas":["登录流程需要人工扫码确认；首次使用可能阻塞等待状态变更","get_messages 使用长轮询（wait=true），需要让 Agent 处理阻塞式调用与超时/最大等待时间（最长约 7 天）","二维码在本地生成并保存（qrcode.txt/qrcode.png）；Agent 侧可能需要处理展示/读取二维码的方式","本地状态/游标持久化依赖目录（~/.mcp-wechat-server/）；并发运行或异常退出可能导致状态不一致（README未明确最佳实践）"]}}