微信公众号文章读取服务

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
   

2. 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
}

🔧 常见问题