Wechat Read MCP In Rust

Wechat Article Read MCP in Rust


一个基于 Rust 实现的 MCP (Model Context Protocol) 服务器，用于读取微信公众号文章内容。

通过 headless Chrome 浏览器渲染微信文章页面，提取标题、作者、发布时间和正文内容，以结构化 JSON 格式返回给 AI 客户端（如 Claude Desktop）。

前言

目前多家业界最佳的大模型厂商如Gemini,Claude,Minimax虽然都有联网搜索功能，但是由于微信公众号的反爬机制，并不能提取到文章内容，本项目旨在赋予LLM实际读取微信公众号文章的能力。

受项目weixin-read-mcp的启发，本项目使用Rust实现，优势在于：

1. 🚀 启动速度 — 编译为原生二进制，无需 Python 解释器和虚拟环境，MCP 服务冷启动从数秒降至毫秒级
2. 📦 分发简便 — 单个可执行文件，无需用户安装 Python / pip / venv
3. 💾 内存占用 — Rust 无 GC 开销，整体内存占用更低
4. 🔒 类型安全 — 编译期保证类型正确，杜绝运行时类型错误
5. ⚡ 解析性能 — HTML 解析和文本处理在 Rust 中显著更快

示例

二进制文件即插即用： 示例图片

✨ 特性

• 单一二进制 — 无需 Python 环境，编译后即可分发
• MCP 协议 — 通过 stdio JSON-RPC 与 AI 客户端集成
• 浏览器渲染 — 使用 Chrome DevTools Protocol 获取 JavaScript 渲染后的完整页面
• 结构化提取 — CSS 选择器精准提取文章元数据和正文

🏗️ 架构

AI Client (Claude Desktop)
    ↕ stdio JSON-RPC (MCP 协议)
main.rs → server.rs → scraper.rs → parser.rs
                          ↕ CDP
                    Chromium (headless)
                          ↓ HTTP
                   mp.weixin.qq.com

📋 前置条件

1. Rust 工具链

   curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

1. Chrome 或 Chromium 浏览器

   # Ubuntu/Debian
   sudo apt install chromium-browser

   # macOS
   brew install --cask chromium

   # Windows
   # 安装 Chrome 浏览器即可

🔨 编译

# 开发构建
cargo build

# 发布构建（优化，推荐用于部署）
cargo build --release

注意: 首次编译 chromiumoxide 较慢（约 60K 行 CDP 代码），后续增量编译会快很多。

🚀 使用

配置 Claude Desktop/Antigravity/Cursor等

编辑相关的配置文件：

{
  "mcpServers": {
    "weixin-reader": {
      //in windows
      "command": "/path/to/weixin-mcp-rs.exe"
      //in linux
      //"command": "/path/to/weixin-mcp-rs"
    }
  }
}

将 /path/to/ 替换为实际的项目路径。

本地测试

# 直接运行（等待 stdin 的 JSON-RPC 输入）
cargo run

# 发送 MCP 初始化请求测试
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"0.1.0"}}}' | cargo run 2>/dev/null

MCP 工具说明

返回格式:

{
  "success": true,
  "title": "文章标题",
  "author": "作者名",
  "publish_time": "2024-01-01",
  "content": "文章正文...",
  "error": null
}

🔧 常见问题