微信本地MCP

安装

macOS:

curl -fsSL https://raw.githubusercontent.com/r266-tech/wechat-cli/main/scripts/install-release.sh | zsh

Windows:

powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/r266-tech/wechat-cli/main/scripts/install-release.ps1 | iex"

默认安装的是 CLI，不注册 MCP，不装后台 watcher。安装完成后命令会放到用户 PATH 上：

• macOS: ~/.local/bin/wechat-cli
• Windows: %LOCALAPPDATA%\Microsoft\WindowsApps\wechat-cli.cmd，如该目录不存在则使用 %USERPROFILE%\.local\bin\wechat-cli.cmd

首次安装前请确认：

• macOS arm64 + WeChat 4.x，或 Windows amd64 + Windows WeChat / Weixin 4.x
• 微信已登录，并至少打开过一个聊天
• macOS 首次 key 初始化可能要求输入一次 Mac admin 密码；密码只输入到本机隐藏提示，不要发给 agent 或网页。密码会存入用户 Keychain，供后续本机 key refresh 使用；安装器也可能临时启动一个 wechat-cli 管理的 WeChat shadow copy 来完成 no-SIP 初始化
• macOS 15+ 建议安装后把 ~/.local/share/wechat-cli/wechat-cli 和 ~/.local/share/wechat-cli/wxkey 加到 Full Disk Access，减少系统隐私弹窗

快速开始

wechat-cli sessions
wechat-cli resolve-chat "张三"
wechat-cli timeline "某个群" --limit 20
wechat-cli history "张三" --view agent --limit 50
wechat-cli search "关键词" --in "某个群"
wechat-cli media "某个群" --type image --limit 10

所有命令面向 agent，stdout 默认输出紧凑 JSON；成功统一返回 {"ok":true,"tool":"...","command":"...","data":...}，失败返回 {"ok":false,"error":...}。--json 可传但只是兼容 no-op，人工查看时用 --pretty。常用命令是薄封装，完整能力都可以通过通用调用访问：

wechat-cli timeline "某个群" --limit 20 --pretty
wechat-cli timeline --help
wechat-cli tool-schema chat_timeline
wechat-cli tools
wechat-cli call chat_timeline --chat "某个群" --limit 20
wechat-cli call-json messages '{"chat":"张三","limit":50,"view":"agent"}'
printf '{"keyword":"会议","limit":20}' | wechat-cli call-json search

timeline --help / tool-schema <command-or-tool> 也返回同一个成功 envelope， data.agent 里包含 agent 示例、分页策略和常见恢复动作。默认 images[] 只暴露 一个最佳可读本地路径：有原图/高清图就返回原图/高清图，只有拿不到时才回落到缩略图。 export 默认 view=agent，JSONL 每行与 timeline message 行同形；需要底层字段时传 --view raw。合并转发里的图片会尽量解析到 forward_chat.items[].images[].path； 只有拿不到来源资源或本地文件不可读时才保留 forward_image_not_resolved。

freshness 是返回数据的新鲜度/诊断信息：例如是否触发过 metadata 自动刷新、分页是否还有下一页、结果是否可能受缺 key 或 cache 滞后影响。