Overview

MCP WeCom Bot Server provides a bridge between AI assistants and WeCom (WeChat Work) group robots, allowing you to send various types of messages directly to your team's WeCom groups. This tool is particularly useful for automated notifications, alerts, and team communications.

Installation

Option 1: Install via Smithery (Recommended)

The easiest way to install MCP WeCom Bot Server for Claude Desktop is via Smithery:

npx -y @smithery/cli install @gotoolkits/mcp-wecombot-server --client claude-desktop

Option 2: Manual Installation

You can also install manually by following these steps:

1. Clone the repository:

   git clone https://github.com/gotoolkits/mcp-wecombot-server.git
   

2. Build the application:

   cd mcp-wecombot-server
   make build
   

3. Create a symbolic link to make it globally available:

   sudo ln -s $PWD/dist/mcp-wecombot-server_xxx_xxxx /usr/local/bin/mcp-wecombot-server
   

   (Replace mcp-wecombot-server_xxx_xxxx with the actual binary file name)

Alternatively, you can download and use the pre-compiled release binary package from the GitHub releases page.

Configuration

To configure the MCP WeCom Bot Server, you need to set up your WeCom robot webhook key. Create a configuration file with the following structure:

{
  "mcpServers": {
    "mcp-wecombot-server": {
      "command": "mcp-wecombot-server",
      "env": {
        "WECOM_BOT_WEBHOOK_KEY": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx"
      }
    }
  }
}

Replace xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx with your actual WeCom robot webhook key.

Getting Your WeCom Robot Webhook Key

1. Follow the WeCom group robot configuration guide
2. After creating your robot, you'll get a webhook URL like: https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=693axxx6-7aoc-4bc4-97a0-0ec2sifa5aaa
3. The part after key= (e.g., 693axxx6-7aoc-4bc4-97a0-0ec2sifa5aaa) is your webhook key

Available Tools

MCP WeCom Bot Server provides several tools for sending different types of messages to WeCom groups:

send_text

Sends a plain text message to a WeCom group.

Example:

Send a text message on WeCom with the content: This is a test message.

send_markdown

Sends a markdown-formatted message to a WeCom group.

Example:

Send a Markdown message on WeCom with the content: # This is a test Markdown message

send_image

Sends an image message to a WeCom group.

send_news

Sends a news message to a WeCom group. A news message includes a title, description, URL, and picture URL.

Example:

Send a graphic message on WeCom with the title: This is a graphic message, the description: This is a graphic message, the link: https://github.com/gotoolkits, and the image: https://img-blog.csdnimg.cn/fcc22710385e4edabccf2451d5f64a99.jpeg

send_template_card

Sends a template card message to a WeCom group.

upload_file

Uploads a file to WeCom.

Use Cases

• Automated notifications for system alerts
• Team announcements
• Project status updates
• Sharing reports and documents
• Sending scheduled reminders

Troubleshooting

If you encounter issues with sending messages, check the following:

• Verify your webhook key is correct
• Ensure your WeCom robot has the necessary permissions
• Check network connectivity to the WeCom API servers