基于MCP技术的微信聊天记录获取和消息发送功能的服务器

基于pywechat工具实现微信自动化操作。

功能特点

此服务器提供以下主要功能：

• 获取微信聊天记录（指定日期）
• 发送单条消息给单个好友
• 发送多条消息给单个好友
• 发送消息给多个好友

可用工具

• wechat_get_chat_history - 获取特定日期的微信聊天记录

  • 必需参数:
    • to_user (字符串): 好友或群聊备注或昵称
    • target_date (字符串): 目标日期，格式为YY/M/D，如25/3/22 -> 暂时不要跨度过长，初始目的就是为了当日的聊天记录

• wechat_send_message - 向单个微信好友发送单条消息

  • 必需参数:
    • to_user (字符串): 好友或群聊备注或昵称
    • message (字符串): 要发送的消息

• wechat_send_multiple_messages - 向单个微信好友发送多条消息

  • 必需参数:
    • to_user (字符串): 好友或群聊备注或昵称
    • messages (数组): 要发送的消息列表 (用英文逗号分隔的字符串输入)

• wechat_send_to_multiple_friends - 向多个微信好友发送单条或者多条消息

  • 必需参数:
    • 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. 发送单条消息给单个好友：

{
  "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 文件。