AI导哈

微信自动化服务器

一个使用辅助功能API和屏幕捕捉技术实现微信自动化的服务器，支持LLM通过编程方式与微信聊天互动。

  • by BiboyQG
  • Python
  • 本地部署
  • 285 星标
  • 更新于
在 GitHub 查看 BiboyQG/WeChat-MCP

使用说明

微信MCP服务器

中文 |英语

一个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

文档

需求

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

贡献

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

许可证

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

相关 MCP