What is Wechat Oa Mcp

wechat_oa_mcp is a Wechat Official Account MCP Server built on the FastMCP framework. It provides a set of practical APIs for managing Wechat Official Accounts, including functionalities for creating, publishing, and deleting drafts.

Use cases

Use cases for wechat_oa_mcp include automating the process of content creation and publication for Wechat Official Accounts, managing marketing campaigns, and integrating Wechat functionalities into AI systems for enhanced user engagement.

How to use

To use wechat_oa_mcp, first install it via pip with the command pip install wechat_oa_mcp. After installation, you need to register on the Wechat Official Platform to obtain your AppID and AppSecret. You can then utilize the provided APIs to manage your Wechat content.

Key features

Key features of wechat_oa_mcp include: obtaining Wechat Access Tokens, creating drafts for articles, publishing drafts to the Official Account, deleting unpublished drafts, and removing permanent materials.

Where to use

wechat_oa_mcp can be used in various fields such as digital marketing, content management, and automated workflows for businesses that utilize Wechat as a communication and marketing platform.

微信公众号 MCP 服务器

这是一个基于 FastMCP 框架的微信公众号MCP服务器，提供了一系列实用的微信公众号 API 接口封装，包括草稿创建、发布、删除等功能。

项目简介

本项目使用 Python 和 FastMCP 框架，通过 Model Control Protocol (MCP) 规范提供微信公众号管理 API，可以轻松集成到各种 AI 系统和自动化工作流程中，帮助用户便捷地管理微信公众号内容。

微信公众平台

微信公众平台官方网址：https://mp.weixin.qq.com

您需要先在微信公众平台注册并创建公众号，获取开发者ID(AppID)和密钥(AppSecret)才能使用本工具。

安装方法

使用 pip 安装

pip install wechat_oa_mcp

项目结构

./
├── README.md              # 项目文档
├── examples/              # 使用示例
│   └── simple_usage.py    # 简单使用示例
├── setup.py               # 安装配置
├── pyproject.toml         # Python项目配置
└── wechat_oa_mcp/         # 包主目录
    ├── __init__.py        # 包初始化文件
    ├── __main__.py        # 模块直接执行入口
    ├── cli.py             # 命令行工具入口
    └── server.py          # 主要功能代码

依赖项

• Python 3.10+
• fastmcp
• requests

功能列表

本服务器提供以下功能:

• 获取微信 Access Token: 获取接口调用凭证
• 创建微信公众号草稿: 创建图文消息草稿
• 发布微信公众号草稿: 将草稿发布到公众号
• 删除微信公众号草稿: 删除未发布的草稿
• 删除永久素材: 删除公众号中的永久素材

API 接口说明

1. 获取 Access Token

WeChat_get_access_token

输入参数:

输出:

{
  "success": true,
  "error": null,
  "access_token": "获取到的access_token",
  "expires_in": 7200
}

2. 创建草稿

WeChat_create_draft

输入参数:

输出:

{
  "success": true,
  "error": null,
  "draft_media_id": "草稿的media_id",
  "image_media_id": "封面图片的media_id"
}

3. 发布草稿

WeChat_publish_draft

输入参数:

输出:

{
  "success": true,
  "error": null,
  "errmsg": "ok",
  "publish_id": "发布任务id"
}

4. 删除草稿

WeChat_del_draft

输入参数:

输出:

{
  "success": true,
  "error": null,
  "errcode": 0,
  "errmsg": "ok"
}

5. 删除永久素材

WeChat_del_material

输入参数:

输出:

{
  "success": true,
  "error": null,
  "errcode": 0,
  "errmsg": "ok"
}

使用方法

1. 安装服务器

# 通过pip安装
pip install wechat_oa_mcp

2. 调用MCP Server的几种方式

2.1 通过代码调用

您可以通过以下方式在Python代码中直接调用微信MCP API（只需完成安装步骤即可使用）：

from wechat_oa_mcp import (
    WeChat_get_access_token, 
    WeChat_create_draft,
    WeChat_publish_draft,
    WeChat_del_draft,
    WeChat_del_material
)

# 获取access_token
token_result = WeChat_get_access_token({
    "AppID": "您的微信AppID", 
    "AppSecret": "您的微信AppSecret"
})

if token_result["success"]:
    access_token = token_result["access_token"]
    
    # 创建草稿
    draft_result = WeChat_create_draft({
        "access_token": access_token,
        "image_url": "https://example.com/image.jpg",
        "title": "测试文章标题",
        "content": "<p>这是文章内容</p>",
        "author": "作者名称"
    })
    
    if draft_result["success"]:
        draft_id = draft_result["draft_media_id"]
        image_id = draft_result["image_media_id"]
        
        # 发布草稿
        publish_result = WeChat_publish_draft({
            "access_token": access_token,
            "draft_media_id": draft_id
        })
        
        if publish_result["success"]:
            print(f"发布成功！发布ID: {publish_result['publish_id']}")
            
        # 删除草稿示例
        # 注意：通常在发布后才会删除草稿，这里仅为演示API用法
        del_draft_result = WeChat_del_draft({
            "access_token": access_token,
            "media_id": draft_id
        })
        
        if del_draft_result["success"]:
            print(f"删除草稿成功：{del_draft_result['errmsg']}")
        
        # 删除素材示例
        # 注意：通常在不需要图片素材时才会删除，这里仅为演示API用法
        del_material_result = WeChat_del_material({
            "access_token": access_token,
            "media_id": image_id
        })
        
        if del_material_result["success"]:
            print(f"删除素材成功：{del_material_result['errmsg']}")

2.2 通过MCP Inspector进行调试

只需完成安装步骤后，即可使用以下命令进行交互测试：

npx @modelcontextprotocol/inspector python -m wechat_oa_mcp

之后访问 http://localhost:6274 可进行交互测试

2.3 通过json添加mcp server

注意：此方式需要先启动MCP服务器

1. 首先通过命令行启动服务：

# 直接启动（默认端口8000）
wechat-oa-mcp
# 或者
python -m wechat_oa_mcp 

# 指定端口启动
wechat-oa-mcp --port 8123
# 或者
python -m wechat_oa_mcp --port 8123

2. 然后将微信MCP服务器添加到其他MCP兼容应用（如Cursor）的配置中：

{
  "mcpServers": {
    "wechat_oa_mcp": {
      "type": "sse",
      "url": "http://localhost:8000/sse"
    }
  }
}

配置参数说明：

• type: 通信协议类型，支持"sse"(Server-Sent Events)
• url: 服务器地址，默认端口为8000。如果之前指定了port，则以指定端口号为准
• wechat_oa_mcp: 服务器名称，可自定义

技术架构

本项目基于 FastMCP 框架，通过 MCP 协议提供微信公众号相关服务。服务器采用模块化设计，每个功能都封装为独立的 MCP 工具，可以单独调用。

服务器内部通过 HTTP 请求与微信公众号 API 通信，处理认证、参数校验等细节，让使用者可以专注于业务逻辑而不用关心底层实现。

使用限制

为了分散服务器压力，每个IP每分钟内最多能调用同一接口五次。

IP白名单配置

根据微信公众号开发接口管理规定，通过开发者ID及密码调用获取access_token接口时，需要设置访问来源IP为白名单。请将以下IP添加至微信公众号-设置与开发-开发接口管理-IP白名单：

106.15.125.133

致谢

• 感谢 FastMCP 项目提供的框架支持

免责声明：此 MCP 服务器仅限研究用途，禁止用于商业目的。