https://github.com/panxingfeng/mcp_server_wechat
基于MCP技术，操作微信发送消息和获取历史记录
https://github.com/panxingfeng/mcp_server_wechat
Last synced: 3 months ago
JSON representation
基于MCP技术，操作微信发送消息和获取历史记录
- Host: GitHub
- URL: https://github.com/panxingfeng/mcp_server_wechat
- Owner: panxingfeng
- License: mit
- Created: 2025-04-18T18:22:36.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-07-06T19:30:50.000Z (5 months ago)
- Last Synced: 2025-07-06T20:36:49.423Z (5 months ago)
- Language: Python
- Homepage:
- Size: 3.72 MB
- Stars: 20
- Watchers: 1
- Forks: 3
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - **mcp_server_wechat** - 基于MCP技术，操作微信发送消息和获取历史记录 `python` `mcp` `pip install git+https://github.com/panxingfeng/mcp_server_wechat` (🤖 AI/ML)
README
# MCP Server WeChat
基于MCP技术的微信聊天记录获取和消息发送功能的服务器，使用[pywechat](https://github.com/Hello-Mr-Crab/pywechat)工具实现微信自动化操作。
## 功能特点
此服务器提供以下主要功能：
- 获取微信聊天记录（指定日期）
- 发送单条消息给单个好友
- 发送多条消息给单个好友
- 发送消息给多个好友
## 可用工具
- `wechat_get_chat_history` - 获取特定日期的微信聊天记录
- 必需参数:
- `to_user` (string): 好友或群聊备注或昵称
- `target_date` (string): 目标日期，格式为YY/M/D，如25/3/22 -> 暂时不要跨度过长，初始目的就是为了当日的聊天记录
- `wechat_send_message` - 向单个微信好友发送单条消息
- 必需参数:
- `to_user` (string): 好友或群聊备注或昵称
- `message` (string): 要发送的消息
- `wechat_send_multiple_messages` - 向单个微信好友发送多条消息
- 必需参数:
- `to_user` (string): 好友或群聊备注或昵称
- `messages` (array): 要发送的消息列表 (用英文逗号分隔的字符串输入)
- `wechat_send_to_multiple_friends` - 向多个微信好友发送单条或者多条消息
- 必需参数:
- `to_user` (array): 好友或群聊备注或昵称列表 (用英文逗号分隔的字符串输入)
- `message` (string/array): 要发送的消息 (单条消息会发给所有好友；多条消息用英文逗号分隔且数量与好友数相同时，将分别发送给对应好友)
## 安装方法
### 使用 pip 安装
```bash
pip install mcp_server_wechat
获取最新
pip install --upgrade mcp_server_wechat
```
## 使用示例
### 配置为 MCP 服务
在您的 MCP 配置中添加：
```json
{
"mcpServers": {
"wechat": {
"command": "python",
"args": ["-m", "mcp_server_wechat","--folder-path=存放历史记录的目录"]
}
}
}
```
### 调用示例
1. 获取聊天记录:
```json
{
"name": "wechat_get_chat_history",
"arguments": {
"to_user": "张三",
"target_date": "25/3/22"
}
}
```
2. 发送单条消息:
```json
{
"name": "wechat_send_message",
"arguments": {
"to_user": "张三",
"message": "你好，这是一条测试消息"
}
}
```
3. 发送多条消息:
```json
{
"name": "wechat_send_multiple_messages",
"arguments": {
"to_user": "张三",
"messages": "你好","这是第一条消息","这是第二条消息"
}
}
```
4. 发送给多个好友(单条消息):
```json
{
"name": "wechat_send_to_multiple_friends",
"arguments": {
"to_user": ["张三", "李四", "王五"],
"message": "大家好，这是一条群发消息"或者"你好，张三","你好，李四","你好，王五"
}
}
```
## 调试
您可以使用 MCP inspector 来调试服务器:
```bash
npx @modelcontextprotocol/inspector python -m mcp_server_wechat
```
## 实际效果展示
inspector的测试
基于我自己chat_mcp的测试
## 注意事项
- 使用本工具需要保持微信桌面版处于登录状态
- 获取聊天记录和发送消息需要确保微信窗口能够被正常操作
- 在使用过程中，请勿手动操作微信窗口，以免干扰自动化操作
- 请勿使用此工具进行任何违反微信服务协议的行为
## 许可证
mcp_server_wechat 使用 MIT 许可证。这意味着您可以自由使用、修改和分发此软件，但需遵守 MIT 许可证的条款和条件。详情请参阅项目仓库中的 LICENSE 文件。