Wechat Official

Provides MCP-based access to WeChat Official Account API for authentication, media, drafts, and publishing with local storage and security.

typescript

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "xwang152-jack-wechat-official-account-mcp": {
      "command": "npx",
      "args": [
        "wechat-official-account-mcp",
        "mcp",
        "-a",
        "<your_app_id>",
        "-s",
        "<your_app_secret>"
      ],
      "env": {
        "CORS_ORIGIN": "https://a.example.com,https://b.example.com",
        "WECHAT_MCP_SECRET_KEY": "your-strong-secret-key"
      }
    }
  }
}

You can run a dedicated MCP server to integrate 微信公众号 (WeChat Official Account) API with your AI applications. This server handles authentication,素材 management, drafts, and publishing, while storing data locally and aligning with the MCP protocol for smooth interoperability.

How to use

You connect your MCP client to the WeChat Official Account MCP Server by configuring an MCP server entry. Use either a local stdio-based server or a globally installed CLI variant. Once running, your AI applications can manage AppID/AppSecret, access tokens, materials, drafts, and publication flow against your WeChat Official Account.

How to install

Prerequisites you need on your system before starting:

Node.js 18+ installed
A working internet connection to install dependencies
Git to clone repositories (optional)

Option 1: Quick start with npx (recommended)

# Start the MCP server directly with npx
npx wechat-official-account-mcp mcp -a <your_app_id> -s <your_app_secret>

# If you use SSE mode, ensure CORS origin is whitelisted

Option 2: Global installation

# Install globally
npm install -g wechat-official-account-mcp

# Start the MCP server
wechat-mcp mcp -a <your_app_id> -s <your_app_secret>

Option 3: Local development workflow

# 1. Clone the project
git clone https://github.com/xwang152-jack/wechat-official-account-mcp.git
cd wechat-official-account-mcp

# 2. Install dependencies
npm install

# 3. Build the project
npm run build

# 4. Start the server locally
node dist/src/cli.js mcp -a <your_app_id> -s <your_app_secret>

Additional install details

CLI options you will use regularly include -a/--app-id and -s/--app-secret to provide your WeChat Official Account credentials. Optional mode -m/--mode accepts stdio (default) or sse. When running in SSE mode, you can set a port with -p/--port. For cross-origin control in production, configure CORS_ORIGIN in your environment.

Available tools

authenticate

Manage WeChat AppID/AppSecret configuration and access tokens, including refreshing tokens and viewing current configuration.

media_upload

Upload and manage temporary WeChat materials such as images, audio, video, and thumbnails.

upload_image

Upload images for rich text content without consuming main material library limits and return usable image URLs.

permanent_media

Manage永久素材 including add, get, delete, list, and count operations.

draft

Create, retrieve, delete, list, and count WeChat article drafts.

publish

Submit drafts for publishing and monitor their status, delete and list existing publications.

Built by

VeilStrat

AI signals for GTM teams