Multi-Bot Support

WeCom Bot MCP Server supports configuring and using multiple bots, allowing you to route messages to different groups or use different bots for different purposes.

Why Multiple Bots?

• Separate concerns: Use different bots for alerts, CI/CD notifications, and team updates
• Multiple groups: Send messages to different WeCom groups
• Access control: Different teams can have their own bots

Configuration Methods

Method 1: JSON Configuration (Recommended)

Configure all bots in a single JSON environment variable:

Linux/macOS

export WECOM_BOTS='{
  "alert": {
    "name": "Alert Bot",
    "webhook_url": "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxx",
    "description": "For system alerts"
  },
  "ci": {
    "name": "CI Bot",
    "webhook_url": "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=yyy",
    "description": "For CI/CD notifications"
  },
  "team": {
    "name": "Team Bot",
    "webhook_url": "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=zzz",
    "description": "For team updates"
  }
}'

Windows PowerShell

$env:WECOM_BOTS = '{"alert": {"name": "Alert Bot", "webhook_url": "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxx", "description": "For system alerts"}, "ci": {"name": "CI Bot", "webhook_url": "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=yyy", "description": "For CI/CD notifications"}}'

Method 2: Individual Environment Variables

Set separate environment variables for each bot:

export WECOM_BOT_ALERT_URL="https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxx"
export WECOM_BOT_CI_URL="https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=yyy"
export WECOM_BOT_NOTIFY_URL="https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=zzz"

Bot IDs are derived from the variable name (lowercase): WECOM_BOT_ALERT_URL → alert

Method 3: Combined Mode

Use WECOM_WEBHOOK_URL as the default bot and add more bots:

# Default bot
export WECOM_WEBHOOK_URL="https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=default"

# Additional bots
export WECOM_BOT_ALERT_URL="https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=alert"
export WECOM_BOT_CI_URL="https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=ci"

MCP Client Configuration

Claude Desktop / Windsurf / Cline

{
  "mcpServers": {
    "wecom": {
      "command": "uvx",
      "args": ["wecom-bot-mcp-server"],
      "env": {
        "WECOM_WEBHOOK_URL": "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=default",
        "WECOM_BOTS": "{\"alert\": {\"name\": \"Alert Bot\", \"webhook_url\": \"https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=alert\"}, \"ci\": {\"name\": \"CI Bot\", \"webhook_url\": \"https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=ci\"}}"
      }
    }
  }
}

Using Multiple Bots

With AI Assistant

The AI assistant automatically knows about available bots. You can specify which bot to use:

USER: "Send a critical alert to the alert bot: Server CPU is above 90%"
ASSISTANT: [Uses send_message with bot_id="alert"]

USER: "Send build success notification to the CI bot"
ASSISTANT: [Uses send_message with bot_id="ci"]

USER: "What WeCom bots are available?"
ASSISTANT: [Uses list_wecom_bots tool to show all bots]

With Python API

from wecom_bot_mcp_server import send_message, send_wecom_file, send_wecom_image

# Send to default bot
await send_message("Hello!", msg_type="text")

# Send to specific bot
await send_message(
    content="⚠️ High CPU usage detected!",
    msg_type="markdown",
    bot_id="alert"
)

# Send file to CI bot
await send_wecom_file("/path/to/report.pdf", bot_id="ci")

# Send image to team bot
await send_wecom_image("/path/to/chart.png", bot_id="team")

List Available Bots

from wecom_bot_mcp_server.bot_config import list_available_bots, get_bot_registry

# List all bots
bots = list_available_bots()
for bot in bots:
    print(f"Bot: {bot['id']} - {bot['name']} - {bot['description']}")

# Check if a bot exists
registry = get_bot_registry()
if registry.has_bot("alert"):
    print("Alert bot is configured")

# Get bot count
print(f"Total bots: {registry.get_bot_count()}")

Best Practices

1. Use descriptive names: Give bots meaningful names and descriptions
2. Separate concerns: Use different bots for different purposes
3. Default bot: Always configure a default bot for general messages
4. Document your bots: Keep track of which bot is for which purpose

Troubleshooting

Bot Not Found Error

If you get "Bot 'xxx' not found", check:

1. The bot ID is correct (case-insensitive)
2. The environment variable is set correctly
3. Restart your MCP client after configuration changes

List Available Bots

Use the list_wecom_bots MCP tool or Python API to see all configured bots:

from wecom_bot_mcp_server.bot_config import list_available_bots
print(list_available_bots())