Skip to main content
Glama
cocohahaha

wechat-local-mcp

by cocohahaha

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
WECHAT_KEYS_FILENoPath to the JSON file containing decryption keys.$HOME/.config/wechat-local-mcp/keys.json
WECHAT_CONTAINER_DIRNoThe directory containing WeChat data files.$HOME/Library/Containers/com.tencent.xinWeChat/Data/Documents
WECHAT_DECRYPTED_DIRNoDirectory where decrypted database snapshots are stored.$HOME/Library/Application Support/wechat-local-vault/decrypted/current

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
wechat_status

只读检查微信版本、加密数据库、密钥文件和明文聊天快照是否就绪。不会读取或返回聊天正文。

wechat_ui_diagnose

使用 macOS 截图和本机 Vision OCR 诊断微信主窗口是否可读。仅在安装 ui 可选依赖并授予屏幕录制权限后使用;不会发送、输入或保存截图。

wechat_list_recent_chats

当明文数据库快照还未准备好时,用本机 OCR 读取当前微信窗口左侧可见的最近会话。不会修改界面内容以外的任何数据。

wechat_read_chat_ui

用 OCR 打开指定聊天并读取最近可见/可滚动的消息。它是数据库快照不可用时的只读兜底,消息可能缺少精确时间戳和发送者识别。

wechat_find_todos_ui

对 OCR 读取到的当前聊天消息运行本地启发式待办提取;结果需要人工确认,不会写入任务系统。

wechat_sync

将本机微信 db_storage 中有对应 64 位十六进制密钥的数据库,解密到独立的本地只读快照目录。不会修改微信源文件、不会发送消息。建议退出微信后执行。

wechat_list_chats

列出明文快照中的联系人和群聊,支持关键词与 offset/limit 分页。

wechat_read_chat

按联系人昵称、备注、群名或微信 ID 读取消息;可用 ISO-8601 时间范围和 limit 限制结果。

wechat_search_messages

在全部聊天或指定聊天中搜索文本消息,支持时间范围、offset/limit 和 JSON/Markdown 输出。

wechat_recent_messages

从指定聊天或全部聊天中按时间倒序返回最近消息。

wechat_find_todos

在最近 N 天的聊天文本中用可解释的中英文行动项启发式筛选待办候选;结果需要人工确认,不会自动创建任务或发送消息。

wechat_chat_summary

返回指定聊天的消息量、参与者、行动项候选和最近消息,供模型进一步生成摘要。

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/cocohahaha/wechat-local-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server