MCP Server Wechat

🚀 MCP技術に基づく微信チャット履歴取得とメッセージ送信機能のサーバー

このサーバーは、pywechatツールを使用して、微信の自動化操作を実現します。

🚀 クイックスタート

このサーバーは、以下の主要機能を提供します。

• 指定日付の微信チャット履歴を取得する
• 単一の友人に1つのメッセージを送信する
• 単一の友人に複数のメッセージを送信する
• 複数の友人にメッセージを送信する

✨ 主な機能

利用可能なツール

• wechat_get_chat_history - 特定の日付の微信チャット履歴を取得する

  • 必須パラメータ:
    • to_user (文字列): 友人またはグループチャットの備考またはニックネーム
    • target_date (文字列): 対象日付。形式はYY/M/D、例えば25/3/22。現時点では長期間の指定は避け、主に当日のチャット履歴取得を想定しています。

• wechat_send_message - 単一の微信友人に1つのメッセージを送信する

  • 必須パラメータ:
    • to_user (文字列): 友人またはグループチャットの備考またはニックネーム
    • message (文字列): 送信するメッセージ

• wechat_send_multiple_messages - 単一の微信友人に複数のメッセージを送信する

  • 必須パラメータ:
    • to_user (文字列): 友人またはグループチャットの備考またはニックネーム
    • messages (配列): 送信するメッセージのリスト（英文のカンマで区切った文字列で入力）

• wechat_send_to_multiple_friends - 複数の微信友人に1つまたは複数のメッセージを送信する

  • 必須パラメータ:
    • to_user (配列): 友人またはグループチャットの備考またはニックネームのリスト（英文のカンマで区切った文字列で入力）
    • message (文字列/配列): 送信するメッセージ（単一のメッセージはすべての友人に送信されます；複数のメッセージは英文のカンマで区切り、友人の数と同じ数のメッセージを指定すると、それぞれの友人に個別に送信されます）

📦 インストール

pipを使用したインストール

pip install mcp_server_wechat

最新版を取得する場合は
pip install --upgrade mcp_server_wechat

💻 使用例

基本的な使用法

以下はいくつかの使用例です。

1. 微信チャット履歴を取得する:

{
  "command": "wechat_get_chat_history",
  "to_user": "ユーザーのニックネームまたは備考名",
  "target_date": "25/3/22"
}

2. 単一の友人に1つのメッセージを送信する:

{
  "command": "wechat_send_message",
  "to_user": "ユーザーのニックネームまたは備考名",
  "message": "送信するメッセージ内容"
}

3. 単一の友人に複数のメッセージを送信する:

{
  "command": "wechat_send_multiple_messages",
  "to_user": "ユーザーのニックネームまたは備考名",
  "messages": "メッセージ1, メッセージ2, メッセージ3"
}

4. 複数の友人にメッセージを送信する:

{
  "command": "wechat_send_to_multiple_friends",
  "to_user": "ユーザー1, ユーザー2, ユーザー3",
  "message": "単一のメッセージ内容" または ["メッセージ1", "メッセージ2", "メッセージ3"]
}

🔧 デバッグ

デバッグするには、以下のコマンドを実行します。

mcp-inspector

📚 ドキュメント

画像1: inspectorのテスト画面

説明: MCPサーバーのテスト画面。

画像2: 複数ツールのテスト画面

説明: 複数のツールを使用したテストのシナリオ。

⚠️ 重要提示

使用中は、以下の注意事項を守ってください。

1. チャット履歴の取得やメッセージの送信時には、微信ウィンドウが正常に操作できることを確認してください。
2. 使用中は、手動で微信ウィンドウを操作しないでください。これにより自動化操作が妨げられる可能性があります。
3. このツールを使用して、微信のサービス規約に違反する行為を行わないでください。

📄 ライセンス

mcp_server_wechatはMITライセンスを使用しています。これは、あなたがこのソフトウェアを自由に使用、変更、配布できることを意味しますが、MITライセンスの条項と条件に従う必要があります。詳細は、プロジェクトリポジトリのLICENSEファイルを参照してください。