📱 mcp-wechat-server - 在 AI 中运行微信

Name: mcp-wechat-server
Author: Itzelma2310

🧩 此工具的作用

mcp-wechat-server 让 AI 应用程序可以在你的 Windows PC 上发送和读取微信消息。

当你需要以下功能时可以使用它：

让 AI 代理回复微信聊天
统一登录和消息处理入口
使用二维码登录，无需输入密码
消息轮询，以便应用程序可以等待新消息
在你的电脑上运行的简单设置

它作为一个 MCP 服务器运行，因此可以连接到支持模型上下文协议 (Model Context Protocol) 的 AI 工具。

📥 下载

在此处打开下载页面：

访问下载页面

如果你使用的是 Windows，请使用此页面获取最新文件，然后下载并运行该应用程序。

🪟 Windows 设置

在 Windows PC 上按照以下步骤操作。

1. 打开下载页面

前往：

https://github.com/Itzelma2310/mcp-wechat-server

查找最新版本或项目主文件。

2. 下载应用程序

从页面下载 Windows 文件或软件包。

如果你看到发布文件，请将其保存到你可以找到的文件夹中，例如：

下载 (Downloads)
桌面 (Desktop)
文档 (Documents)

3. 安装 Bun

此应用程序需要 Bun 才能运行。

从以下地址获取 Bun：

https://bun.sh/

安装后，打开命令提示符 (Command Prompt) 或 PowerShell 并检查它是否正常工作：

bun -v

如果你看到版本号，说明 Bun 已准备就绪。

4. 启动服务器

在保存应用程序的文件夹中打开命令提示符或 PowerShell。

运行：

bunx mcp-wechat-server

这将启动微信服务器。

5. 连接你的 AI 应用程序

将服务器添加到你的 AI 应用程序的 MCP 设置中。

使用此设置：

{
  "mcpServers": {
    "wechat": {
      "command": "bunx",
      "args": ["mcp-wechat-server"]
    }
  }
}

如果你的应用程序使用不同的配置文件，请在其中添加相同的命令。

6. 使用二维码登录

服务器启动时，它可以创建用于微信登录的二维码。

你可以通过以下方式之一进行扫描：

终端中的文本二维码
PNG 二维码图片
URL 链接

用手机上的微信扫描代码并完成登录。

🔧 系统要求

使用满足以下条件的 Windows PC：

Windows 10 或 Windows 11
2 GB 可用磁盘空间
稳定的互联网连接
Bun 1.0 或更高版本
手机上有一个可用的微信账号

为获得最佳效果，请在服务器运行时保持电脑开启。

⚙️ 工作原理

该应用程序为你的 AI 工具提供了一些关键操作：

登录微信
检查新消息
发送文本消息
显示输入状态
重启后保持状态

它使用长轮询，因此可以等待新消息，而不是频繁检查。如果需要，它可以长时间等待。

🚀 AI 应用程序快速入门

Claude Desktop

将其添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "wechat": {
      "command": "bunx",
      "args": ["mcp-wechat-server"]
    }
  }
}

OpenCode

将其添加到 opencode.json：

{
  "mcp": {
    "wechat": {
      "type": "local",
      "command": ["bunx", "mcp-wechat-server"],
      "enabled": true
    }
  }
}

Cursor 或其他 MCP 客户端

使用：

{
  "command": "bunx",
  "args": ["mcp-wechat-server"]
}

📲 首次登录

启动应用程序后，请执行以下操作：

等待二维码出现
在手机上打开微信
扫描二维码
确认登录

如果代码以文本形式出现在终端中，你可以将其复制到二维码查看器中，或者如果应用程序创建了 PNG 图片，则使用该图片。

💬 发送和读取消息

登录后，AI 代理可以：

读取收到的消息
发送文本回复
检查消息状态
在工作时显示输入状态

这有助于 AI 在微信中充当聊天助手。

🗂️ 已保存的数据

该应用程序会在你的电脑上保留本地状态。

这包括：

登录信息
消息位置数据
会话状态

如果你重启应用程序，它可以继续工作，而无需从头开始。

🛠️ Windows 上的常见设置步骤

如果应用程序无法启动

检查以下几点：

已安装 Bun
你在正确的文件夹中运行了命令
你的互联网连接正常
配置文件使用了正确的命令

如果二维码没有出现

尝试以下操作：

停止应用程序
再次启动它
检查终端窗口中的二维码文本
等待几秒钟以获取图片或链接

如果微信无法登录

确保：

你扫描的是最新的二维码
你的手机可以访问网络
登录请求已在微信中确认

如果你的 AI 应用程序无法连接

检查 MCP 配置：

命令应为 bunx
参数应包含 mcp-wechat-server
配置文件应已保存
更改后应重启 AI 应用程序

🧠 工具列表

此服务器包含 6 个用于微信任务的 MCP 工具。

它们涵盖：

登录
消息轮询
文本发送
输入状态
会话状态
消息流控制

🔒 隐私和本地使用

服务器在你的机器上运行。

这意味着：

你的登录信息保留在你的 PC 上
消息状态保留在本地
你控制应用程序何时运行

📁 简单的设置路径

如果你想在 Windows 上走最简单的路径：

打开 GitHub 页面
下载或克隆项目
安装 Bun
运行 bunx mcp-wechat-server
将 MCP 配置添加到你的 AI 应用程序
在微信中扫描二维码

🧭 基本使用流程

启动服务器
使用二维码登录
连接你的 AI 应用程序
让 AI 读取和发送消息
在使用时保持应用程序运行

📌 启动后的预期情况

当应用程序启动时，你可能会看到：

终端窗口
二维码文本
登录提示
控制台中的消息活动

这是正常的。应用程序会等待微信登录，然后为你的 AI 工具处理消息。

🧰 有用的命令

如果你想先测试 Bun，请使用：

bun -v

如果你想再次启动服务器，请使用：

bunx mcp-wechat-server

🖥️ 面向非技术用户

如果你不习惯使用命令行，请按照这个简单的顺序操作：

下载应用程序
安装 Bun
打开文件夹
运行命令
扫描二维码
连接你的 AI 应用程序

如果你会复制和粘贴文本，你就可以完成设置。

mcp-wechat-server