返回项目列表
2026/2/3

mcp-server-wechat

想让你的AI助手直接读取和分析微信公众号内容吗？这个开源项目解决了大难题！ 它基于MCP标准协议，为AI Agent（如Claude）提供了标准化的微信公众号内容访问能力。核心亮点是“双数据源”设计：既支持微信官方API获取自有公众号内容，也通过搜索引擎获取公开文章，解决了个人开发者获取权限难、爬虫不稳定的痛点。 开发者可以一键集成到Claude Desktop，轻松实现公众号搜索、文章内容获取、批量处理等功能。无论你是想用AI分析行业动态、研究内容趋势，还是监控竞品，它都能让内容获取变得简单高效。 开源免费，支持自部署，是AI时代知识工作者的效率利器。点击查看详细配置指南，快速上手！

FastMCP
477 浏览16 分钟阅读
源码

产品介绍

产品概述

产品定位

微信公众号 MCP Server 是一个基于 FastMCP 2.0+ 框架的 Model Context Protocol 服务器，为 AI Agent 提供微信公众号文章访问和管理能力。通过标准化的 MCP 协议，让 AI 助手能够无缝集成微信公众号内容获取功能。

目标用户

  • 主要用户：知识工作者、AI 应用开发者、内容创作者、研究人员
  • 次要用户：数据分析师、营销人员、媒体工作者
  • 用户画像：具备一定技术背景或懂得配置MCP工具，需要批量处理或分析微信公众号内容，关注内容获取的效率和准确性

核心价值主张

"为 AI Agent 提供标准化的微信公众号内容访问能力，让内容获取变得简单、高效、可靠"

市场分析

市场背景

  • 微信生态规模：微信公众号作为中文互联网最重要的内容平台之一，拥有数百万活跃账号
  • 内容获取痛点：微信有防止爬虫获取内容机制，AI无法直接读取公众号相关内容
  • AI 集成需求：随着 AI Agent 的普及，知识工作者借助AI对公众号内容进行抓取分析的需求自然出现

竞品分析

解决方案优势劣势差异化
微信官方 API数据权威，稳定可靠需要公众号权限，功能有限双数据源设计，官方 API + 搜索引擎
爬虫工具功能灵活，覆盖面广稳定性差，易被封禁基于 MCP 标准协议，易于集成
第三方服务开箱即用成本高，依赖性强开源免费，可自部署

市场定位

细分市场：AI Agent 内容获取工具 竞争策略：标准化 + 开源，提供双数据源保障，专注 MCP 生态集成，做"AI Agent 微信内容获取"的首选方案

用户研究

用户调研发现

痛点分析

  1. 集成复杂：缺乏标准化的微信内容获取接口
  2. 权限门槛：官方 API 需要公众号权限，个人开发者难以获取
  3. 数据格式：不同来源的数据格式不统一，处理复杂
  4. 稳定性差：现有爬虫方案容易被封禁，稳定性不佳

用户需求层次

基础需求：获取微信公众号文章内容
期望需求：搜索和筛选相关文章
兴奋需求：智能的内容分析和处理

用户故事

核心用户故事

作为一个 知识工作者 我希望 能够轻松地让我的 AI Agent 访问微信公众号内容 以便于 为我进行公众号内容的分析处理

详细用户故事

  1. 内容获取

    • 作为开发者，我希望通过标准化接口获取公众号文章
    • 以便在我的应用中集成微信内容分析功能

  2. 内容搜索

    • 作为研究人员，我希望能够搜索特定主题的公众号文章
    • 以便进行内容分析和趋势研究

  3. 批量处理

    • 作为数据分析师，我希望能够批量获取公众号的历史文章
    • 以便进行大规模的内容挖掘和分析

  4. 实时监控

    • 作为营销人员，我希望能够监控竞品公众号的内容更新
    • 以便及时了解行业动态和竞争情况

产品功能设计

功能架构

微信公众号 MCP Server 功能架构
├── 核心工具
│   ├── get_account_info - 获取公众号基本信息
│   ├── list_articles - 列出公众号文章列表
│   ├── get_article_content - 获取文章详细内容
│   ├── search_public_articles - 搜索公开文章
│   ├── get_public_article_content - 获取公开文章内容
│   └── search_accounts - 搜索公众号
├── 技术特性
│   ├── 双数据源设计（官方 API + 搜狗搜索）
│   ├── 智能缓存系统
│   ├── 异步 I/O 处理
│   ├── 多格式响应（JSON/Markdown）
│   └── 完整错误处理
└── 集成支持
    ├── MCP 标准协议
    ├── Claude Desktop 集成
    ├── FastMCP 框架
    └── 可视化调试界面

用户体验设计

设计原则

1. 标准化优先

  • 协议兼容：严格遵循 MCP 标准协议
  • 接口一致：所有工具保持一致的输入输出格式
  • 文档完整：提供详细的 API 文档和使用示例

2. 开发者友好

  • 易于集成：一键安装到 Claude Desktop
  • 调试便利：提供可视化调试界面
  • 错误清晰：提供可操作的错误消息和解决建议

3. 性能可靠

  • 智能缓存：减少重复请求，提高响应速度
  • 异步处理：支持高并发访问
  • 容错机制：双数据源保障服务可用性

用户旅程地图

开发者首次使用

发现项目 → 了解功能 → 快速安装 → 配置环境 → 测试工具 → 集成应用
   ↓         ↓         ↓         ↓         ↓         ↓
GitHub/文档  README   一键脚本   环境变量   MCP调试   生产部署

核心使用流程

启动服务 → 连接客户端 → 调用工具 → 获取内容 → 处理数据 → 应用集成
   ↓         ↓         ↓         ↓         ↓         ↓
MCP Server  Claude等   API调用   结构化数据  业务逻辑   用户服务

技术架构

系统架构

  • 框架：基于 FastMCP 2.0+ 框架
  • 协议：遵循 MCP (Model Context Protocol) 标准
  • 语言：Python 3.8+，使用 async/await 异步编程
  • 验证：Pydantic v2 进行输入验证和类型检查
  • 传输：支持 STDIO 和 HTTP 两种传输协议

数据源设计

  1. 微信公众号官方 API

    • 需要 AppID 和 AppSecret
    • 提供权威的公众号数据
    • 适用于自有公众号内容管理

  2. 搜狗微信搜索

    • 无需认证凭据
    • 覆盖所有公开内容
    • 适用于内容搜索和发现

缓存策略

  • 内存缓存：热点数据快速访问
  • 文件缓存：持久化存储，跨会话复用
  • 智能过期：根据内容类型设置不同过期时间

风险管理

技术风险

1. API 限制风险

风险描述：微信官方 API 有调用频率和权限限制 应对措施：

  • 实现智能缓存减少 API 调用
  • 提供搜索引擎作为备选数据源
  • 详细的错误处理和用户提示

2. 反爬风险

风险描述：搜索引擎可能实施反爬措施 应对措施：

  • 合理控制请求频率
  • 实现请求重试机制
  • 提供官方 API 作为主要数据源

3. 数据合规风险

风险描述：内容获取可能涉及版权和隐私问题 应对措施：

  • 仅获取公开发布的内容
  • 不存储敏感用户信息
  • 提供完整的免责声明

部署和维护

部署方式

  1. 本地开发：使用 fastmcp dev 进行开发调试
  2. 客户端集成：一键安装到 Claude Desktop 等 MCP 客户端
  3. 服务器部署：支持 STDIO 和 HTTP 两种部署模式

Claude Code 配置指南

快速配置步骤

步骤 1：环境准备

  1. 确保已安装 uv（Python 包管理工具）

    # 检查是否已安装
uv --version

# 如果未安装，执行以下命令
curl -LsSf https://astral.sh/uv/install.sh | sh

  2. 进入项目目录并安装依赖

    cd /path/to/your/mcp-server-wechat
uv sync

步骤 2：配置微信公众号凭据（可选）

如果您有微信公众号的开发权限：

  1. 复制配置模板

    cp .env.example .env

  2. 编辑配置文件

    # 使用任意文本编辑器打开 .env 文件
nano .env
# 或
code .env

  3. 填入您的凭据

    WECHAT_APPID=your_app_id_here
WECHAT_SECRET=your_app_secret_here

获取微信公众号凭据的方法：

重要提示：即使没有微信公众号凭据，您仍可以使用搜索功能获取公开文章！

步骤 3：在 Claude Code 中配置 MCP 服务器

  1. 打开 Claude Code 设置

    • 在 Claude Code 界面中找到设置选项
    • 寻找 "MCP Servers" 或 "Model Context Protocol" 配置部分

  2. 添加 MCP 服务器配置（推荐使用 uvx）

    {
  "name": "wechat-mcp",
  "command": "uvx",
  "args": [
    "--from",
    "/path/to/your/mcp-server-wechat",
    "mcp-server-wechat"
  ],
  "env": {
    "WECHAT_APPID": "your_app_id_here",
    "WECHAT_SECRET": "your_app_secret_here"
  }
}

    备选方案（使用 uv run）：

    {
  "name": "wechat-mcp",
  "command": "uv",
  "args": [
    "run",
    "--directory",
    "/path/to/your/mcp-server-wechat",
    "python",
    "src/mcp_server_wechat/server.py"
  ],
  "env": {
    "WECHAT_APPID": "your_app_id_here",
    "WECHAT_SECRET": "your_app_secret_here"
  }
}

    注意：

    • 将路径替换为您的实际项目路径
    • 如果没有微信凭据，可以省略 env 部分

步骤 4：测试配置

  1. 重启 Claude Code

  2. 测试可用功能

    无需凭据即可使用的功能：

    • 搜索公开文章：询问 "搜索关于人工智能的微信文章"
    • 获取文章内容：提供文章链接获取内容
    • 搜索公众号：询问 "搜索机器之心公众号"

    需要凭据的功能：

    • 获取公众号信息：询问 "获取我的公众号基本信息"
    • 列出文章：询问 "列出我公众号的最新文章"
    • 获取文章详情：询问 "获取指定文章的详细内容"

使用示例

配置完成后，您可以在 Claude Code 中这样使用：

搜索公开文章

请帮我搜索关于"ChatGPT"的微信公众号文章，找到最新的5篇

获取文章内容

请帮我获取这篇文章的详细内容：https://mp.weixin.qq.com/s/xxxxx

搜索公众号

请帮我搜索"机器之心"相关的公众号

管理自己的公众号（需要凭据）

请帮我获取我的公众号基本信息

请列出我公众号最近发布的10篇文章

常见问题解决

1. 命令找不到

# 确保 uv 在 PATH 中
echo $PATH
which uv

2. 权限问题

# 给脚本执行权限
chmod +x src/mcp_server_wechat/server.py

3. 依赖安装失败

# 重新安装依赖
uv sync --reinstall

4. 配置不生效

  • 检查 JSON 配置格式是否正确
  • 确认路径是否正确
  • 重启 Claude Code

功能限制说明

搜索功能（无需凭据）

  • ✅ 搜索任何公开发布的微信文章
  • ✅ 获取文章完整内容
  • ✅ 搜索公众号信息
  • ⚠️ 受搜狗微信搜索反爬限制，建议适度使用

官方 API 功能（需要凭据）

  • ✅ 获取自己公众号的完整信息
  • ✅ 管理和查看自己发布的文章
  • ✅ 获取文章统计数据
  • ⚠️ 需要已认证的公众号
  • ⚠️ 有 API 调用次数限制

项目链接

GitHub 仓库: [mcp-server-wechat](https://github.com/odyecho/mcp-server-wechat MCP 生态: Model Context Protocol