Skip to main content
Glama
YanQiu0207

wxpush-mcp

by YanQiu0207

wxpush-mcp

wxpush 的 MCP 服务端,将微信推送能力封装为 MCP 工具,供 Claude Desktop、Claude Code 等支持 MCP 协议的客户端直接调用。

前置条件:已有一个运行中的 wxpush 服务实例。若尚未部署,参见 wxpush-py。

工具

工具名

参数

说明

send_wechat_message

title、content、shortid

发送微信模板消息给指定用户

check_health

无

检测 MCP 服务器配置与后端服务是否正常

shortid 在服务端 config.toml [users] 中定义,调用方无需感知 OpenID。

Related MCP server: wxauto MCP Server

快速接入

前置条件

已安装 uv(uvx 随 uv 一起提供)。

所需环境变量

环境变量

说明

WXPUSH_URL

wxpush 服务地址,如 https://your-server.com

WXPUSH_TOKEN

API 访问令牌,与服务端 API_TOKEN 一致

Claude Code

在 ~/.claude.json 的 mcpServers 中添加:

{
  "mcpServers": {
    "wxpush": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/YanQiu0207/wxpush-mcp",
        "wxpush-mcp"
      ],
      "env": {
        "WXPUSH_URL": "https://your-server.com",
        "WXPUSH_TOKEN": "your-token"
      }
    }
  }
}

Claude Desktop

在 claude_desktop_config.json 中添加相同配置:

  • macOS:~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows:%APPDATA%\Claude\claude_desktop_config.json

验证

配置完成并重启客户端后,调用 check_health 工具,正常响应:

OK: wxpush service reachable (HTTP 200)

更新

uvx 默认会缓存已安装版本。如需拉取最新代码,在终端执行:

uv cache clean wxpush-mcp

重启客户端后生效。

Related MCP Connectors

  • Let Claude or ChatGPT search, read and send your WhatsApp messages over MCP. OAuth sign-in.

  • WhatsMCP connects Claude and other MCP-compatible AI agents directly to WhatsApp. Send and receive text, images, documents, and voice notes; manage groups (create, add/remove members, promote admins); look up contacts and profiles; follow channels; and read call and message history — all through a standard MCP interface. For voice use cases, WhatsMCP offers SIP-based calling plans (inbound-only, or full inbound/outbound) so AI voice agents can answer and place WhatsApp calls, plus low-latency WebSocket integrations with voice agent providers like ElevenLabs. Multiple WhatsApp accounts can be paired and managed per workspace, with webhook support for real-time inbound message delivery to your own infrastructure.

  • Any REST/SOAP/GraphQL/OData/SQL API as MCP tools for Claude & ChatGPT. 262 connectors: SAP, ERP.

    1935
  • Messaging tools for AI agents: send messages, manage chats, groups and channels.

Related MCP Servers

  • F
    license
    Not graded
    quality
    D
    maintenance
    Enables AI assistants to send WeChat messages through automation, supporting both immediate and scheduled message delivery to contacts and groups using the Model Context Protocol standard.
    36
    -
  • A
    license
    B
    quality
    C
    maintenance
    Provides WeChat automation capabilities for AI development tools via the Model Context Protocol. It enables users to send messages, manage contacts, and handle file transfers through AI assistants like Claude and Cursor.
    27
    30
    MIT
  • F
    license
    Not graded
    quality
    D
    maintenance
    Bridges WeChat and Claude Code via MCP, enabling message sending, receiving, and automated processing through tools like wechat_poll and wechat_send.
    -