📱 mcp-wechat-server — Запуск WeChat в ИИ

Name: mcp-wechat-server
Author: Itzelma2310

🧩 Что это делает

mcp-wechat-server позволяет ИИ-приложению отправлять и читать сообщения WeChat на вашем ПК с Windows.

Используйте его, если вам нужно:

чтобы ИИ-агент отвечал в чатах WeChat
единое место для входа и обработки сообщений
вход по QR-коду вместо ввода паролей
опрос сообщений, чтобы приложение могло ожидать новые сообщения
простая настройка, которая работает на вашем компьютере

Он работает как MCP-сервер, поэтому подключается к ИИ-инструментам, поддерживающим протокол Model Context Protocol.

📥 Скачивание

Откройте страницу загрузки здесь:

Посетить страницу загрузки

Если вы используете Windows, перейдите на эту страницу, чтобы получить последние файлы, а затем скачайте и запустите приложение оттуда.

🪟 Настройка в Windows

Выполните следующие действия на ПК с Windows.

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. Подключите ваше ИИ-приложение

Добавьте сервер в настройки MCP вашего ИИ-приложения.

Используйте следующую настройку:

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

Если ваше приложение использует другой файл конфигурации, добавьте ту же команду туда.

6. Войдите с помощью QR-кода

Когда сервер запускается, он может создать QR-код для входа в WeChat.

Вы можете отсканировать его одним из следующих способов:

текстовый QR-код в терминале
PNG-изображение QR-кода
URL-ссылка

Отсканируйте код с помощью WeChat на телефоне и завершите вход.

🔧 Системные требования

Используйте ПК с Windows, на котором установлены:

Windows 10 или Windows 11
2 ГБ свободного места на диске
стабильное интернет-соединение
Bun 1.0 или новее
работающий аккаунт WeChat на телефоне

Для достижения наилучших результатов не выключайте ПК во время работы сервера.

⚙️ Как это работает

Приложение предоставляет вашему ИИ-инструменту несколько ключевых действий:

вход в WeChat
проверка новых сообщений
отправка текстовых сообщений
отображение статуса набора текста
сохранение состояния после перезапуска

Он использует длинный опрос (long polling), поэтому может ожидать новые сообщения, вместо того чтобы проверять их слишком часто. При необходимости он может ждать долгое время.

🚀 Быстрый старт для ИИ-приложений

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-изображение, если приложение его создает.

💬 Отправка и чтение сообщений

После входа в систему ИИ-агент может:

читать входящие сообщения
отправлять текстовые ответы
проверять статус сообщения
показывать статус набора текста во время работы

Это помогает ИИ действовать как чат-ассистент в WeChat.

🗂️ Сохраненные данные

Приложение хранит локальное состояние на вашем компьютере.

Сюда входит:

информация для входа
данные о позиции сообщений
состояние сессии

Если вы перезапустите приложение, оно сможет продолжить работу без необходимости начинать все сначала.

🛠️ Общие шаги по настройке в Windows

Если приложение не запускается

Проверьте следующее:

установлен ли Bun
выполнили ли вы команду в нужной папке
работает ли ваше интернет-соединение
использует ли файл конфигурации правильную команду

Если QR-код не появляется

Попробуйте следующее:

остановите приложение
запустите его снова
проверьте окно терминала на наличие текста QR-кода
подождите несколько секунд, пока появится изображение или ссылка

Если вход в WeChat не выполняется

Убедитесь, что:

вы отсканировали последний QR-код
у вашего телефона есть доступ к сети
запрос на вход был принят в WeChat

Если ваше ИИ-приложение не может подключиться

Проверьте конфигурацию MCP:

команда должна быть bunx
аргументы должны включать mcp-wechat-server
файл конфигурации должен быть сохранен
ИИ-приложение должно быть перезапущено после внесения изменений

🧠 Список инструментов

Этот сервер включает 6 инструментов MCP для задач WeChat.

Они охватывают:

вход
опрос сообщений
отправку текста
статус набора текста
состояние сессии
управление потоком сообщений

🔒 Конфиденциальность и локальное использование

Сервер работает на вашем компьютере.

Это означает, что:

ваши данные для входа остаются на вашем ПК
состояние сообщений остается локальным
вы контролируете, когда приложение работает

📁 Простой путь настройки

Если вы хотите максимально быстро настроить все в Windows:

откройте страницу GitHub
скачайте или клонируйте проект
установите Bun
выполните bunx mcp-wechat-server
добавьте конфигурацию MCP в ваше ИИ-приложение
отсканируйте QR-код в WeChat

🧭 Базовый рабочий процесс

запустите сервер
войдите с помощью QR-кода
подключите ваше ИИ-приложение
позвольте ИИ читать и отправлять сообщения
держите приложение запущенным во время использования

📌 Чего ожидать после запуска

Когда приложение запускается, вы можете увидеть:

окно терминала
текст QR-кода
запрос на вход
активность сообщений в консоли

Это нормально. Приложение ожидает входа в WeChat, а затем обрабатывает сообщения для вашего ИИ-инструмента.

🧰 Полезная команда

Если вы хотите сначала протестировать Bun, используйте:

bun -v

Если вы хотите снова запустить сервер, используйте:

bunx mcp-wechat-server

🖥️ Для нетехнических пользователей

Если вы не привыкли к командной строке, следуйте этому простому порядку:

скачайте приложение
установите Bun
откройте папку
выполните команду
отсканируйте QR-код
подключите ваше ИИ-приложение

Если вы умеете копировать и вставлять текст, вы сможете это настроить.

📍 Скачать снова

Используйте эту страницу, чтобы получить последнюю версию: