biboyqg/wechat-mcp

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

293 stars 88 forks 품질 70 트렌드 20MIT

Repository Install

biboyqg/wechat-mcp는 [[T0]에서 가져온 MCP 서버 후보입니다.

개요

biboyqg/wechat-mcp는 [[T0]에서 가져온 MCP 서버 후보입니다.

개요(AI 번역)

中文 | 영어

접근성 API와 스크린샷을 사용해 macOS에서 WeChat을 자동화하는 MCP 서버입니다. LLM이 WeChat 채팅과 프로그래밍적으로 상호작용할 수 있게 합니다.

특징

📨 채팅(연락처 또는 그룹)에서 최근 메시지를 가져오기
✍️ 채팅 기록을 기반으로 자동 응답 전송
📷 텍스트 전용 모멘츠 게시물 게시, 선택 가능한 초안 전용 모드
👥 설정 가능한 개인정보 보호 기능을 갖춘 WeChat ID를 이용한 연락처 추가
🔍 정확한 이름 일치를 위한 스마트 채팅 검색
🤖 스마트 위챗 자동화를 위한 5개의 특수 Claude 코드 서브에이전트

퀵 스타트

설치

클로드 코드로 설정

Claude 데스크톱으로 설정

코덱스와의 설정

macOS 권한

⚠️ 중요: 터미널에 접근성 권한을 부여하기:

오픈 시스템 설정 → 개인정보 및 보안 → 접근성
터미널 애플리케이션(Terminal.app, iTerm2 등)을 추가하세요.
서버를 사용하기 전에 위챗이 실행 중인지 확인하세요

사용

기본 명령어

사용 가능한 MCP 도구

fetch_messages_by_chat - 채팅에서 최근 메시지 받기
reply_to_messages_by_chat - 채팅에 답장 보내기

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

An MCP server that automates WeChat on macOS using the Accessibility API and screen capture. It enables LLMs to interact with WeChat chats programmatically.

Features

📨 Fetch recent messages from any chat (contact or group)
✍️ Send automated replies based on chat history
📷 Publish text-only Moments posts, with optional draft-only mode
👥 Add contacts using WeChat ID with configurable privacy
🔍 Smart chat search with exact name matching
🤖 5 specialized Claude Code sub-agents for smart WeChat automation

Quick Start

Installation

pip install wechat-mcp-server

Setup with Claude Code

# 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

macOS Permissions

⚠️ Important: Grant Accessibility permissions to your terminal:

Open System Settings → Privacy & Security → Accessibility
Add your terminal application (Terminal.app, iTerm2, etc.)
Ensure WeChat is running before using the server

Usage

Basic Commands

# 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

Available MCP Tools

fetch_messages_by_chat - Get recent messages from a chat
reply_to_messages_by_chat - Send a reply to a chat
add_contact_by_wechat_id - Add a new contact using a WeChat ID and send a friend request
publish_moment_without_media - Publish a text-only Moments post (no photos or videos); optionally only prepare a draft without posting via publish=False

See detailed API documentation for full tool specifications.

Claude Code Sub-Agents

GitHub에서 전체 README 보기

설치

This server does not publish a one-line install command.

Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

// 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"
      ],
    }
  }
}