We Chat MCP

微信MCP服务器

 ](https://pypi.org/project/wechat-mcp-server/) 

中文 |英语

一个MCP服务器，使用Accessibility API和屏幕截图在macOS上自动化微信。它使LLM能够以编程方式与微信聊天进行交互。

特性

• 📨 从任何聊天室（联系人或群）获取最近的消息
• ✍️ 根据聊天记录发送自动回复
• 📷 发布纯文本的Moments帖子，具有可选的纯草稿模式
• 👥 使用可配置隐私的微信ID添加联系人
• 🔍 智能聊天搜索，精确匹配姓名
• 🤖 5个专门用于智能微信自动化的Claude Code子代理

快速开始

安装

pip install wechat-mcp-server

使用Claude代码进行设置

# If installed via pip
claude mcp add --transport stdio wechat-mcp -- wechat-mcp

# If using uv for development
claude mcp add --transport stdio wechat-mcp -- uv --directory $(pwd) run wechat-mcp

Setup with Claude Desktop

// If installed via pip
{
  "mcpServers": {
    "wechat-mcp": {
      "type": "stdio",
      "command": "wechat-mcp"
    }
  }
}

// If using uv for development
{
  "mcpServers": {
    "wechat-mcp": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "--directory",
        "{path/to/wechat-mcp}",
        "run",
        "wechat-mcp"
      ],
    }
  }
}

Setup with Codex

# If installed via pip
codex mcp add wechat-mcp -- wechat-mcp

# If using uv for development
codex mcp add wechat-mcp -- uv --directory $(pwd) run wechat-mcp

macOS权限

⚠️ 重要：向您的终端授予辅助功能权限：

1. 打开 系统设置→ 隐私和安全→ 无障碍
2. 添加您的终端应用程序（terminal.app、iTerm2等）
3. 在使用服务器之前，确保微信正在运行

用法

基本命令

# Run with default stdio transport
wechat-mcp --transport stdio

# Run with HTTP transport
wechat-mcp --transport streamable-http

# Run with SSE transport
wechat-mcp --transport sse

可用的MCP工具

• fetch_messages_by_chat -从聊天中获取最新消息
• reply_to_messages_by_chat -向聊天室发送回复
• add_contact_by_wechat_id -使用微信ID添加新联系人并发送好友请求
• publish_moment_without_media -发布纯文本的Moments帖子（没有照片或视频）；可选择仅准备草稿，不通过以下方式发布 publish=False

看 API详细文件 了解完整的工具规格。

克劳德代码子代理

该项目包括5个专门为微信自动化设计的智能子代理。它们通过Claude Code实现了微信的自然语言控制。

可用子代理

1. 聊天摘要 -总结聊天记录并提取关键信息
2. 自动应答器 -自动生成并发送适当的回复
3. 消息搜索器 -搜索聊天记录以获取特定内容
4. 多聊天检查器 -监控多个聊天记录并对消息进行优先级排序
5. 聊天见解 -分析关系动态和沟通模式

📖 查看完整的子代理指南

发展

带uv的本地设置

# Install uv
curl -LsSf https://astral.sh/uv/install.sh | sh

# Clone and setup
git clone https://github.com/yourusername/WeChat-MCP.git
cd WeChat-MCP
uv sync

# Run locally
uv run wechat-mcp --transport stdio

文档

• 📘 详细指南 -完整的API文档和体系结构
• 🤖 子代理指南 -如何使用Claude Code子代理

需求

• macOS（使用辅助功能API）
• Mac版微信已安装并正在运行
• Python 3.12+
• 终端的访问权限

贡献

欢迎投稿！请随时提交拉取请求。

许可证

MIT许可证-请参阅 许可证 详细信息文件