📱 mcp-wechat-server - AI에서 WeChat 실행하기

Name: mcp-wechat-server
Author: Itzelma2310

🧩 이 도구의 기능

mcp-wechat-server를 사용하면 AI 앱이 Windows PC에서 WeChat 메시지를 보내고 읽을 수 있습니다.

다음과 같은 경우에 사용하세요:

AI 에이전트가 WeChat 채팅에 답장하게 하고 싶을 때
로그인 및 메시지 처리를 한곳에서 관리하고 싶을 때
비밀번호 입력 대신 QR 코드 로그인을 사용하고 싶을 때
앱이 새 메시지를 기다릴 수 있도록 메시지 폴링이 필요할 때
컴퓨터에서 실행되는 간단한 설정이 필요할 때

이 도구는 MCP 서버로 작동하므로 Model Context Protocol을 지원하는 AI 도구와 연결됩니다.

📥 다운로드

여기에서 다운로드 페이지를 여세요:

다운로드 페이지 방문

Windows를 사용하는 경우, 이 페이지에서 최신 파일을 가져온 다음 앱을 다운로드하여 실행하세요.

🪟 Windows 설정

Windows PC에서 다음 단계를 따르세요.

1. 다운로드 페이지 열기

다음으로 이동하세요:

https://github.com/Itzelma2310/mcp-wechat-server

최신 릴리스 또는 주요 프로젝트 파일을 찾으세요.

2. 앱 다운로드

페이지에서 Windows 파일 또는 패키지를 다운로드하세요.

릴리스 파일이 보이면 다음과 같이 찾기 쉬운 폴더에 저장하세요:

다운로드
바탕 화면
문서

3. Bun 설치

이 앱을 실행하려면 Bun이 필요합니다.

다음에서 Bun을 받으세요:

https://bun.sh/

설치 후 명령 프롬프트(Command Prompt)나 PowerShell을 열고 작동하는지 확인하세요:

bun -v

버전 번호가 보이면 Bun이 준비된 것입니다.

4. 서버 시작

앱이 저장된 폴더에서 명령 프롬프트나 PowerShell을 여세요.

다음 명령을 실행하세요:

bunx mcp-wechat-server

그러면 WeChat 서버가 시작됩니다.

5. AI 앱 연결

AI 앱의 MCP 설정에 서버를 추가하세요.

다음 설정을 사용하세요:

{
  "mcpServers": {
    "wechat": {
      "command": "bunx",
      "args": ["mcp-wechat-server"]
    }
  }
}

앱에서 다른 구성 파일을 사용하는 경우, 동일한 명령을 거기에 추가하세요.

6. QR 코드로 로그인

서버가 시작되면 WeChat 로그인을 위한 QR 코드를 생성할 수 있습니다.

다음 방법 중 하나로 스캔할 수 있습니다:

터미널의 텍스트 QR 코드
PNG QR 코드 이미지
URL 링크

휴대폰의 WeChat으로 코드를 스캔하여 로그인을 완료하세요.

🔧 시스템 요구 사항

다음 사양을 갖춘 Windows PC를 사용하세요:

Windows 10 또는 Windows 11
2GB 이상의 여유 디스크 공간
안정적인 인터넷 연결
Bun 1.0 이상
휴대폰에서 작동 중인 WeChat 계정

최상의 결과를 위해 서버가 실행되는 동안 PC를 켜두세요.

⚙️ 작동 원리

이 앱은 AI 도구에 다음과 같은 주요 작업을 제공합니다:

WeChat 로그인
새 메시지 확인
텍스트 메시지 전송
입력 상태 표시
재시작 후 상태 유지

이 도구는 긴 폴링(long polling)을 사용하므로 너무 자주 확인하는 대신 새 메시지를 기다릴 수 있습니다. 필요에 따라 오랫동안 대기할 수 있습니다.

🚀 AI 앱을 위한 빠른 시작

Claude Desktop

claude_desktop_config.json에 다음을 추가하세요:

{
  "mcpServers": {
    "wechat": {
      "command": "bunx",
      "args": ["mcp-wechat-server"]
    }
  }
}

OpenCode

opencode.json에 다음을 추가하세요:

{
  "mcp": {
    "wechat": {
      "type": "local",
      "command": ["bunx", "mcp-wechat-server"],
      "enabled": true
    }
  }
}

Cursor 또는 기타 MCP 클라이언트

다음을 사용하세요:

{
  "command": "bunx",
  "args": ["mcp-wechat-server"]
}

📲 첫 로그인

앱을 시작한 후 다음을 수행하세요:

QR 코드가 나타날 때까지 기다립니다.
휴대폰에서 WeChat을 엽니다.
QR 코드를 스캔합니다.
로그인을 확인합니다.

코드가 터미널에 텍스트로 나타나면 QR 뷰어에 복사하거나 앱이 생성한 PNG 이미지를 사용할 수 있습니다.

💬 메시지 보내기 및 읽기

로그인 후 AI 에이전트는 다음을 수행할 수 있습니다:

수신 메시지 읽기
텍스트 답장 보내기
메시지 상태 확인
작업 중 입력 상태 표시

이는 AI가 WeChat에서 채팅 비서처럼 행동하도록 돕습니다.

🗂️ 저장된 데이터

앱은 컴퓨터에 로컬 상태를 유지합니다.

여기에는 다음이 포함됩니다:

로그인 정보
메시지 위치 데이터
세션 상태

앱을 재시작해도 처음부터 다시 시작할 필요 없이 계속 작동할 수 있습니다.

🛠️ Windows에서의 일반적인 설정 단계

앱이 시작되지 않는 경우

다음 사항을 확인하세요:

Bun이 설치되어 있는지
올바른 폴더에서 명령을 실행했는지
인터넷 연결이 작동하는지
구성 파일이 올바른 명령을 사용하는지

QR 코드가 나타나지 않는 경우

다음을 시도하세요:

앱을 중지하세요.
다시 시작하세요.
터미널 창에서 QR 텍스트를 확인하세요.
이미지나 링크가 나타날 때까지 몇 초간 기다리세요.

WeChat 로그인이 안 되는 경우

다음 사항을 확인하세요:

최신 QR 코드를 스캔했는지
휴대폰이 네트워크에 연결되어 있는지
WeChat에서 로그인 요청이 수락되었는지

AI 앱이 연결할 수 없는 경우

MCP 구성을 확인하세요:

명령은 bunx여야 합니다.
인수는 mcp-wechat-server를 포함해야 합니다.
구성 파일이 저장되어야 합니다.
변경 후 AI 앱을 재시작해야 합니다.

🧠 도구 목록

이 서버에는 WeChat 작업을 위한 6개의 MCP 도구가 포함되어 있습니다.

다음 기능을 다룹니다:

로그인
메시지 폴링
텍스트 전송
입력 상태
세션 상태
메시지 흐름 제어

🔒 개인정보 보호 및 로컬 사용

서버는 사용자의 컴퓨터에서 실행됩니다.

즉, 다음을 의미합니다:

로그인 정보가 PC에 유지됩니다.
메시지 상태가 로컬에 유지됩니다.
앱 실행 시점을 사용자가 제어합니다.

📁 간단한 설정 경로

Windows에서 가장 빠른 경로를 원한다면:

GitHub 페이지를 엽니다.
프로젝트를 다운로드하거나 복제합니다.
Bun을 설치합니다.
bunx mcp-wechat-server를 실행합니다.
AI 앱에 MCP 구성을 추가합니다.
WeChat에서 QR 코드를 스캔합니다.

🧭 기본 사용 흐름

서버를 실행합니다.
QR 코드로 로그인합니다.
AI 앱을 연결합니다.
AI가 메시지를 읽고 보내도록 합니다.
사용하는 동안 앱을 계속 실행해 둡니다.

📌 시작 후 예상되는 상황

앱이 시작되면 다음이 보일 수 있습니다:

터미널 창
QR 코드 텍스트
로그인 프롬프트
콘솔의 메시지 활동

이는 정상입니다. 앱은 WeChat 로그인을 기다린 다음 AI 도구를 위한 메시지를 처리합니다.

🧰 유용한 명령

Bun을 먼저 테스트하려면 다음을 사용하세요:

bun -v

서버를 다시 시작하려면 다음을 사용하세요:

bunx mcp-wechat-server

🖥️ 비기술 사용자를 위한 안내

명령줄 사용이 익숙하지 않다면 다음 간단한 순서를 따르세요:

앱을 다운로드합니다.
Bun을 설치합니다.
폴더를 엽니다.
명령을 실행합니다.
QR 코드를 스캔합니다.
AI 앱을 연결합니다.

텍스트를 복사하고 붙여넣을 수 있다면 설정할 수 있습니다.

📍 다시 다운로드

최신 버전을 받으려면 이 페이지를 사용하세요: