📱 mcp-wechat-server - Ejecuta WeChat en IA

Name: mcp-wechat-server
Author: Itzelma2310

🧩 Qué hace esto

mcp-wechat-server permite que una aplicación de IA envíe y lea mensajes de WeChat en tu PC con Windows.

Úsalo cuando quieras:

que un agente de IA responda a chats de WeChat
un lugar centralizado para el inicio de sesión y el manejo de mensajes
inicio de sesión con código QR en lugar de escribir contraseñas
sondeo de mensajes para que la aplicación pueda esperar nuevos mensajes
una configuración sencilla que se ejecuta desde tu computadora

Funciona como un servidor MCP, por lo que se conecta a herramientas de IA que admiten el Protocolo de Contexto de Modelo (Model Context Protocol).

📥 Descarga

Abre la página de descarga aquí:

Visita la página de descarga

Si estás en Windows, usa esta página para obtener los archivos más recientes, luego descarga y ejecuta la aplicación desde allí.

🪟 Configuración en Windows

Sigue estos pasos en un PC con Windows.

1. Abre la página de descarga

Ve a:

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

Busca la versión más reciente o los archivos principales del proyecto.

2. Descarga la aplicación

Descarga el archivo o paquete de Windows desde la página.

Si ves un archivo de lanzamiento, guárdalo en una carpeta que puedas encontrar fácilmente, como:

Descargas
Escritorio
Documentos

3. Instala Bun

Esta aplicación necesita Bun para ejecutarse.

Obtén Bun en:

https://bun.sh/

Después de la instalación, abre el Símbolo del sistema o PowerShell y verifica que funcione:

bun -v

Si ves un número de versión, Bun está listo.

4. Inicia el servidor

Abre el Símbolo del sistema o PowerShell en la carpeta donde se guardó la aplicación.

Ejecuta:

bunx mcp-wechat-server

Esto inicia el servidor de WeChat.

5. Conecta tu aplicación de IA

Agrega el servidor a la configuración MCP de tu aplicación de IA.

Usa esta configuración:

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

Si tu aplicación usa un archivo de configuración diferente, agrega el mismo comando allí.

6. Inicia sesión con un código QR

Cuando el servidor se inicia, puede crear un código QR para el inicio de sesión en WeChat.

Puedes escanearlo de una de estas maneras:

código QR de texto en la terminal
imagen de código QR en formato PNG
enlace URL

Escanea el código con WeChat en tu teléfono y finaliza el inicio de sesión.

🔧 Requisitos del sistema

Usa un PC con Windows con:

Windows 10 o Windows 11
2 GB de espacio libre en disco
una conexión a internet estable
Bun 1.0 o posterior
una cuenta de WeChat activa en tu teléfono

Para obtener mejores resultados, mantén el PC encendido mientras el servidor se ejecuta.

⚙️ Cómo funciona

La aplicación le da a tu herramienta de IA algunas acciones clave:

iniciar sesión en WeChat
buscar nuevos mensajes
enviar mensajes de texto
mostrar el estado de escritura
mantener el estado después de reiniciar

Utiliza sondeo largo (long polling), por lo que puede esperar nuevos mensajes en lugar de verificar con demasiada frecuencia. Puede esperar durante mucho tiempo si es necesario.

🚀 Inicio rápido para aplicaciones de IA

Claude Desktop

Agrega esto a claude_desktop_config.json:

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

OpenCode

Agrega esto a opencode.json:

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

Cursor u otros clientes MCP

Usa:

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

📲 Primer inicio de sesión

Después de iniciar la aplicación, haz lo siguiente:

espera a que aparezca el código QR
abre WeChat en tu teléfono
escanea el código QR
confirma el inicio de sesión

Si el código aparece como texto en la terminal, puedes copiarlo en un visor de códigos QR o usar la imagen PNG si la aplicación crea una.

💬 Envío y lectura de mensajes

Una vez iniciada la sesión, el agente de IA puede:

leer mensajes entrantes
enviar respuestas de texto
verificar el estado del mensaje
mostrar el estado de escritura mientras trabaja

Esto ayuda a que la IA actúe como un asistente de chat en WeChat.

🗂️ Datos guardados

La aplicación mantiene un estado local en tu computadora.

Esto incluye:

información de inicio de sesión
datos de posición de mensajes
estado de la sesión

Si reinicias la aplicación, puede seguir funcionando sin empezar desde cero.

🛠️ Pasos comunes de configuración en Windows

Si la aplicación no se inicia

Verifica estos puntos:

Bun está instalado
ejecutaste el comando en la carpeta correcta
tu conexión a internet funciona
el archivo de configuración usa el comando correcto

Si el código QR no aparece

Intenta esto:

detén la aplicación
iníciala de nuevo
revisa la ventana de la terminal para ver el texto del QR
espera unos segundos para que aparezca la imagen o el enlace

Si WeChat no inicia sesión

Asegúrate de:

haber escaneado el código QR más reciente
que tu teléfono tenga acceso a la red
que la solicitud de inicio de sesión haya sido aceptada en WeChat

Si tu aplicación de IA no puede conectarse

Verifica la configuración de MCP:

el comando debe ser bunx
los argumentos deben incluir mcp-wechat-server
el archivo de configuración debe estar guardado
la aplicación de IA debe reiniciarse después de los cambios

🧠 Lista de herramientas

Este servidor incluye 6 herramientas MCP para tareas de WeChat.

Cubren:

inicio de sesión
sondeo de mensajes
envío de texto
estado de escritura
estado de la sesión
control de flujo de mensajes

🔒 Privacidad y uso local

El servidor se ejecuta en tu máquina.

Eso significa que:

tu inicio de sesión permanece en tu PC
el estado de los mensajes permanece local
tú controlas cuándo se ejecuta la aplicación

📁 Ruta de configuración sencilla

Si quieres el camino más corto en Windows:

abre la página de GitHub
descarga o clona el proyecto
instala Bun
ejecuta bunx mcp-wechat-server
agrega la configuración MCP a tu aplicación de IA
escanea el código QR en WeChat

🧭 Flujo de uso básico

inicia el servidor
inicia sesión con el código QR
conecta tu aplicación de IA
deja que la IA lea y envíe mensajes
mantén la aplicación ejecutándose mientras la usas

📌 Qué esperar después del lanzamiento

Cuando la aplicación se inicia, es posible que veas:

una ventana de terminal
texto de código QR
un aviso de inicio de sesión
actividad de mensajes en la consola

Esto es normal. La aplicación espera el inicio de sesión de WeChat y luego maneja los mensajes para tu herramienta de IA.

🧰 Comando útil

Si quieres probar Bun primero, usa:

bun -v

Si quieres iniciar el servidor de nuevo, usa:

bunx mcp-wechat-server

🖥️ Para usuarios no técnicos

Si no estás acostumbrado a las líneas de comando, sigue este orden sencillo:

descarga la aplicación
instala Bun
abre la carpeta
ejecuta el comando
escanea el código QR
conecta tu aplicación de IA

Si puedes copiar y pegar texto, puedes configurarlo.

📍 Descargar de nuevo

Usa esta página para obtener la versión más reciente: