金大哥 - mcp_server_wechat MCP 详情

article

README

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

本服务器借助 pywechat 工具，实现了微信自动化操作，可高效获取指定日期的微信聊天记录，还能灵活向单个或多个好友发送消息。

🚀 快速开始

该服务器基于 pywechat 工具实现微信自动化操作，为用户提供便捷的微信聊天记录获取和消息发送功能。

✨ 主要特性

获取指定日期的微信聊天记录。
可向单个好友发送单条消息。
支持向单个好友发送多条消息。
能够向多个好友发送单条或多条消息。

📦 安装指南

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

📚 详细文档

可用工具

| 工具名称 | 功能 | 必需参数 | | ---- | ---- | ---- | | 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 (字符串/数组): 要发送的消息 (单条消息会发给所有好友；多条消息用英文逗号分隔且数量与好友数相同时，将分别发送给对应好友) |

调试

要调试，请运行以下命令：

mcp-inspector

实际效果展示

图片1: inspector的测试界面

描述：MCP 服务器的测试界面。

图片2: 多工具测试界面

描述：多个工具进行测试的情景。

⚠️ 注意事项

⚠️ 重要提示

获取聊天记录和发送消息时，确保微信窗口可以正常操作。

使用过程中请勿手动操作微信窗口，以免干扰自动化操作。

请勿利用此工具从事任何违反微信服务协议的行为。

📄 许可证

mcp_server_wechat 使用 MIT 许可证。这意味着您可以自由使用、修改和分发此软件，但需遵守 MIT 许可证的条款和条件。详情请参阅项目仓库中的 LICENSE 文件。

mcp_server_wechat