wecom-bot-mcp-server

wecom-bot-mcp-server

35
communication

The WeCom Bot MCP Server is an MCP-compliant server designed for the WeCom (WeChat Work) bot. It offers support for multiple message types and ensures configurable logging and message history tracking.

WeCom Bot MCP Server

A Model Context Protocol (MCP) compliant server implementation for WeCom (WeChat Work) bot.

Features

  • Supports multiple message types including text, Markdown, image (base64), and file messages.
  • @mention support using user ID or phone number.
  • Tracks message history.
  • Configurable logging system with full type annotations.
  • Data validation using Pydantic.

Requirements

  • Python 3.10+
  • WeCom Bot Webhook URL from WeCom group settings.

Installation

  • Automated Installation: Use Smithery for Claude Desktop or VSCode with Cline Extension.
  • Manual Installation: Available via PyPI.

Usage

  • Start the server using wecom-bot-mcp-server.
  • Provides usage examples for sending messages and files using the MCP protocol.

Development

  • Clone the repository and set up development environment using virtual environments.
  • Use nox and uv for testing, code style checking, and building.

Project Structure

Outlines the directory structure, including src, tests, and docs directories.

License

This project is licensed under the MIT License.