📱 mcp-wechat-server - AIでWeChatを動かす

🧩 このツールの機能

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

📲 初回ログイン

アプリを起動した後、以下の手順を行います：

1. QRコードが表示されるまで待つ

2. スマホでWeChatを開く

3. QRコードをスキャンする

4. ログインを承認する

コードがターミナルにテキストとして表示された場合は、QRビューアにコピーするか、アプリが作成したPNG画像を使用してください。

💬 メッセージの送受信

ログイン後、AIエージェントは以下のことが可能です：

• 受信メッセージの読み取り

• テキスト返信の送信

• メッセージステータスの確認

• 作業中の入力中ステータスの表示

これにより、AIがWeChatのチャットアシスタントのように振る舞うことができます。

🗂️ 保存データ

アプリはコンピュータ上にローカル状態を保持します。

これには以下が含まれます：

• ログイン情報

• メッセージ位置データ

• セッション状態

アプリを再起動しても、最初からやり直すことなく動作を継続できます。

🛠️ Windowsでの一般的なセットアップ手順

アプリが起動しない場合

以下の点を確認してください：

• Bunがインストールされているか

• 正しいフォルダでコマンドを実行したか

• インターネット接続が機能しているか

• 設定ファイルに正しいコマンドが記述されているか

QRコードが表示されない場合

以下を試してください：

• アプリを停止する

• 再度起動する

• ターミナルウィンドウでQRテキストを確認する

• 画像やリンクが表示されるまで数秒待つ

WeChatにログインできない場合

以下を確認してください：

• 最新のQRコードをスキャンしたか

• スマホがネットワークに接続されているか

• WeChatでログインリクエストが承認されたか

AIアプリが接続できない場合

MCP設定を確認してください：

• コマンドは bunx であること

• 引数に mcp-wechat-server が含まれていること

• 設定ファイルが保存されていること

• 変更後にAIアプリが再起動されていること

🧠 ツールリスト

このサーバーには、WeChatタスク用の6つのMCPツールが含まれています。

内容は以下の通りです：

• ログイン

• メッセージポーリング

• テキスト送信

• 入力中ステータス

• セッション状態

• メッセージフロー制御

🔒 プライバシーとローカル利用

サーバーはあなたのマシン上で実行されます。

つまり：

• ログイン情報はPC内に留まる

• メッセージ状態はローカルに保存される

• アプリの実行タイミングを自分で制御できる

📁 シンプルなセットアップ手順

Windowsで最短の手順は以下の通りです：

1. GitHubページを開く

2. プロジェクトをダウンロードまたはクローンする

3. Bunをインストールする

4. bunx mcp-wechat-server を実行する

5. AIアプリにMCP設定を追加する

6. WeChatでQRコードをスキャンする

🧭 基本的な使用フロー

1. サーバーを起動する

2. QRコードでログインする

3. AIアプリを接続する

4. AIにメッセージを読み書きさせる

5. 使用中はアプリを起動したままにする

📌 起動後の動作

アプリ起動時には以下が表示されることがあります：

• ターミナルウィンドウ

• QRコードテキスト

• ログインプロンプト

• コンソールでのメッセージアクティビティ

これは正常な動作です。アプリはWeChatのログインを待機し、その後AIツール用のメッセージを処理します。

🧰 便利なコマンド

まずBunをテストしたい場合は、以下を使用してください：

bun -v

サーバーを再起動したい場合は、以下を使用してください：

bunx mcp-wechat-server

🖥️ 非技術者向け

コマンドラインに慣れていない場合は、以下のシンプルな順序に従ってください：

• アプリをダウンロードする

• Bunをインストールする

• フォルダを開く

• コマンドを実行する

• QRコードをスキャンする

• AIアプリを接続する

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

📍 再ダウンロード

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

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