mcp-wecombot-server is an MCP server designed to seamlessly integrate AI models with WeCom (also known as WeChat Work) group robots. This server empowers AI models to send various message types to WeCom groups, including text, Markdown, images, news articles, and template cards. By leveraging the WeCom bot API, it facilitates real-time communication and notifications from AI-driven applications directly within team collaboration environments.

Developers can use mcp-wecombot-server to build AI-powered workflows that trigger automated alerts, share insights, or facilitate interactive experiences within WeCom. The server supports easy installation via Smithery or manual setup, and it utilizes environment variables for secure webhook key configuration. Its ability to upload files further expands the possibilities for sharing diverse content. This MCP server simplifies the process of connecting AI models to WeCom, enabling efficient and collaborative AI-driven communication.

Text Message Delivery

The mcp-wecombot-server enables AI models to send text-based messages directly to WeCom (WeChat Work) group chats. This functionality allows AI to communicate updates, alerts, or summaries in a human-readable format within a familiar collaboration environment. The server receives text content from the AI model via the MCP and then formats and transmits it to the designated WeCom group using the configured webhook. This ensures that important information generated by the AI is promptly delivered to the relevant team members.

For example, an AI-powered monitoring system could use this feature to send immediate notifications to a DevOps team when a critical server threshold is breached. The message could state: "Alert: CPU usage on Server X has exceeded 90%. Immediate action recommended." This direct communication facilitates faster response times and minimizes potential downtime. The server leverages the WeCom Bot API's text message endpoint for delivery.

Markdown Message Support

This feature extends the text messaging capability by allowing AI models to send formatted messages using Markdown syntax. This allows for richer communication, including headings, lists, and emphasized text, making the messages more readable and easier to understand. The mcp-wecombot-server interprets the Markdown content received from the AI model and translates it into the appropriate format for display within WeCom. This ensures that the messages retain their intended structure and visual appeal.

Consider an AI-driven project management tool that automatically generates status reports. Instead of plain text, it can send a Markdown message to a project team's WeCom group, including a summary of completed tasks (as a bulleted list), upcoming deadlines (in bold), and any potential roadblocks (highlighted with a heading). This structured format improves clarity and allows team members to quickly grasp the project's progress. The server utilizes a Markdown parsing library to convert the Markdown content into a format compatible with the WeCom Bot API.

Image Transmission

The mcp-wecombot-server supports the transmission of images from AI models to WeCom groups. This allows AI to share visual information, such as charts, diagrams, or screenshots, directly with users. The server handles the process of receiving the image data from the AI model, encoding it appropriately, and sending it to the WeCom group via the configured webhook. This feature is particularly useful for AI applications that generate or process visual data.

For instance, an AI-powered data analysis tool could automatically generate charts visualizing key performance indicators (KPIs). Using this feature, the AI can send these charts directly to a management team's WeCom group, providing them with a quick and visual overview of the company's performance. This eliminates the need for manual report generation and distribution, saving time and improving communication efficiency. The server uses the WeCom Bot API's media upload and image message endpoints to handle image transmission.

News Message Dissemination

This feature enables AI models to send news messages, also known as graphic messages, to WeCom groups. A news message consists of a title, description, URL, and an optional picture URL. This allows AI to share links to relevant articles, blog posts, or other online resources with team members, accompanied by a brief summary and a visual preview. The mcp-wecombot-server formats the provided information into a news message and sends it to the WeCom group.

Imagine an AI-powered news aggregator that identifies articles relevant to a specific team's work. It can use this feature to send a news message to the team's WeCom group, linking to the article and providing a brief summary of its content. This keeps the team informed about the latest developments in their field and facilitates knowledge sharing. The server constructs the news message payload according to the WeCom Bot API's specifications.

File Upload Capability

The mcp-wecombot-server provides the functionality to upload files to WeCom. This allows AI models to share documents, spreadsheets, or other file types directly with users within their WeCom groups. The server handles the file upload process, ensuring that the file is properly transmitted and accessible to the intended recipients. This feature is valuable for AI applications that generate or manage files.

Consider an AI-driven document processing system that automatically generates reports in PDF format. Using this feature, the AI can upload the generated PDF report directly to a relevant WeCom group, making it easily accessible to stakeholders. This streamlines the document sharing process and eliminates the need for manual file transfers. The server interacts with the WeCom Bot API's media upload endpoint to upload the file and then sends a message containing the file's media ID.