📱 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/

インストール後、コマンドプロンプトまたは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
2 GBの空きディスク容量
安定したインターネット接続
Bun 1.0 以降
スマホで動作するWeChatアカウント

最良の結果を得るには、サーバー実行中はPCを起動したままにしてください。

⚙️ 仕組み

このアプリは、AIツールに対して以下の主要なアクションを提供します：

WeChatへのログイン
新着メッセージの確認
テキストメッセージの送信
入力中ステータスの表示
再起動後の状態保持

ロングポーリングを使用しているため、頻繁にチェックするのではなく、新しいメッセージを待機できます。必要に応じて長時間待機することも可能です。

🚀 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アプリを接続する

テキストのコピー＆ペーストができれば、セットアップ可能です。

📍 再ダウンロード

最新バージョンを入手するにはこのページを使用してください：