使用说明

项目简介

本项目 'mcp_server_wechat' 基于 Model Context Protocol (MCP) 技术，旨在为大型语言模型 (LLM) 应用提供微信交互能力。作为一个MCP服务器，它封装了微信桌面版的自动化操作，允许LLM客户端通过标准化的MCP协议，安全、可控地获取微信聊天记录和发送消息。

主要功能点

获取微信聊天记录：可以获取指定日期与特定好友或群聊的聊天记录，方便LLM进行上下文学习或信息检索。
发送微信消息：支持向单个或多个微信好友发送单条或多条消息，使LLM具备主动与微信用户交互的能力。
工具化接口：所有功能均以 MCP Tool 的形式暴露，方便LLM客户端通过工具调用方式使用，易于集成和扩展。
易于安装和配置：通过pip即可安装，配置简单，可以快速部署到MCP客户端环境中。

安装步骤

确保已安装Python环境。

打开终端或命令提示符，执行以下命令安装 'mcp_server_wechat'：

pip install mcp_server_wechat

或安装最新版本：

pip install --upgrade mcp_server_wechat

服务器配置

要将 'mcp_server_wechat' 配置为 MCP 服务器，需要在 MCP 客户端的配置文件中添加以下server配置。请注意，'command' 指定了Python解释器路径，'args' 指定了启动 'mcp_server_wechat' 的命令和可选参数 '--folder-path'，用于指定聊天记录的默认保存目录。

"mcpServers": {
  "wechat": {
    "command": "python",
    "args": ["-m", "mcp_server_wechat", "--folder-path=存放历史记录的目录"]
  }
}

配置参数说明：

'server name': 'wechat' (服务器名称，客户端用于引用)
'command': 'python' (运行服务器的命令，这里使用python解释器)
'args': 启动服务器的参数列表
- '-m mcp_server_wechat': 以模块方式运行 'mcp_server_wechat'
- '--folder-path=存放历史记录的目录': 可选参数，指定存放历史记录的目录，请替换为实际的目录路径。如果不需要保存聊天记录到文件，可以省略此参数。

基本使用方法

启动MCP服务器：
- MCP客户端根据上述配置，会自动启动 'mcp_server_wechat' 服务器。
- 确保运行服务器的机器上已登录微信桌面版，并保持微信处于可操作状态。

通过MCP客户端调用工具：

在LLM应用或MCP客户端中，可以使用以下Tool调用来使用微信功能。

获取聊天记录 (wechat_get_chat_history):

{
  "name": "wechat_get_chat_history",
  "arguments": {
    "to_user": "好友备注或昵称",
    "target_date": "YY/M/D，如25/3/22"
  }
}

发送单条消息 (wechat_send_message):

{
  "name": "wechat_send_message",
  "arguments": {
    "to_user": "好友备注或昵称",
    "message": "要发送的消息内容"
  }
}

发送多条消息 (wechat_send_multiple_messages):

{
  "name": "wechat_send_multiple_messages",
  "arguments": {
    "to_user": "好友备注或昵称",
    "messages": ["消息1", "消息2", "消息3"]
  }
}

或者使用英文逗号分隔的字符串：

{
  "name": "wechat_send_multiple_messages",
  "arguments": {
    "to_user": "好友备注或昵称",
    "messages": "消息1,消息2,消息3"
  }
}

发送给多个好友 (wechat_send_to_multiple_friends):

{
  "name": "wechat_send_to_multiple_friends",
  "arguments": {
    "to_user": ["好友1备注或昵称", "好友2备注或昵称"],
    "message": "群发消息内容"
  }
}

或者针对每个好友发送不同的消息（好友数量和消息数量需要一致）：

{
  "name": "wechat_send_to_multiple_friends",
  "arguments": {
    "to_user": ["好友1备注或昵称", "好友2备注或昵称"],
    "message": ["给好友1的消息", "给好友2的消息"]
  }
}