MCP Server Wechat

🚀 Server for WeChat Chat Record Retrieval and Message Sending Based on MCP Technology

This server leverages the pywechat tool to achieve automated WeChat operations, enabling efficient retrieval of chat records and seamless message sending.

🚀 Quick Start

This server is implemented based on the pywechat tool to achieve automated WeChat operations.

✨ Features

The server offers the following key features:

• Retrieve WeChat chat records for a specified date.
• Send a single message to a single friend.
• Send multiple messages to a single friend.
• Send messages to multiple friends.

📦 Available Tools

• wechat_get_chat_history - Retrieve WeChat chat records for a specific date.

  • Required parameters:
    • to_user (string): The alias or nickname of the friend or group chat.
    • target_date (string): The target date in the format YY/M/D, e.g., 25/3/22. Note: Avoid overly long time spans initially; the primary purpose is to retrieve the current day's chat records.

• wechat_send_message - Send a single message to a single WeChat friend.

  • Required parameters:
    • to_user (string): The alias or nickname of the friend or group chat.
    • message (string): The message to be sent.

• wechat_send_multiple_messages - Send multiple messages to a single WeChat friend.

  • Required parameters:
    • to_user (string): The alias or nickname of the friend or group chat.
    • messages (array): A list of messages to be sent (input as a comma-separated string).

• wechat_send_to_multiple_friends - Send single or multiple messages to multiple WeChat friends.

  • Required parameters:
    • to_user (array): A list of aliases or nicknames of friends or group chats (input as a comma-separated string).
    • message (string/array): The message to be sent. If it's a single message, it will be sent to all friends. If it's multiple messages separated by commas and the number matches the number of friends, each message will be sent to the corresponding friend.

📦 Installation

Install via pip

pip install mcp_server_wechat

# Get the latest version
pip install --upgrade mcp_server_wechat

💻 Usage Examples

Here are several usage examples:

Basic Usage

1. Retrieve WeChat chat records:

{
  "command": "wechat_get_chat_history",
  "to_user": "User nickname or alias",
  "target_date": "25/3/22"
}

2. Send a single message to a single friend:

{
  "command": "wechat_send_message",
  "to_user": "User nickname or alias",
  "message": "Content of the message to be sent"
}

3. Send multiple messages to a single friend:

{
  "command": "wechat_send_multiple_messages",
  "to_user": "User nickname or alias",
  "messages": "Message 1, Message 2, Message 3"
}

4. Send messages to multiple friends:

{
  "command": "wechat_send_to_multiple_friends",
  "to_user": "User 1, User 2, User 3",
  "message": "Single message content" or ["Message 1", "Message 2", "Message 3"]
}

🛠️ Debugging

To debug, run the following command:

mcp-inspector

🖼️ Actual Effect Demonstration

Image 1: Inspector Test Interface

Description: The test interface of the MCP server.

Image 2: Multi-Tool Test Interface

Description: The scenario of testing multiple tools.

⚠️ Important Note

When using this server, please adhere to the following precautions:

1. Ensure that the WeChat window can be operated normally when retrieving chat records and sending messages.
2. Avoid manual operations on the WeChat window during use to prevent interference with automated operations.
3. Do not use this tool for any actions that violate the WeChat service agreement.

📄 License

The mcp_server_wechat is licensed under the MIT License. This means you are free to use, modify, and distribute the software, but you must comply with the terms and conditions of the MIT License. For details, please refer to the LICENSE file in the project repository.