WeCom Bot MCP Server

A WeCom (WeChat Work) bot server implemented with FastMCP, supporting message sending via webhook.

中文文档 | English

Features

• Built on FastMCP framework
• Markdown message format support
• Asynchronous message sending
• Message history tracking
• Complete type hints
• Comprehensive unit tests

Installation

Using pip:

pip install wecom-bot-mcp-server

Or using poetry (recommended):

poetry add wecom-bot-mcp-server

Usage

1. Set environment variable:

# Windows PowerShell
$env:WECOM_WEBHOOK_URL="your WeCom bot webhook URL"

# Linux/macOS
export WECOM_WEBHOOK_URL="your WeCom bot webhook URL"

2. Run the server:

# Run directly after installation
wecom-bot-mcp-server

Or use in code:

from wecom_bot_mcp_server.server import main

# Start server
if __name__ == "__main__":
    main()

3. Send messages:

from wecom_bot_mcp_server.server import send_message, get_message_history

# Send a message
await send_message("Hello, WeCom!")

# Get message history
history = get_message_history()

Cline Configuration

1. Install dependency:

poetry add wecom-bot-mcp-server

2. Configure Cline MCP settings:

Configure the Cline MCP settings file in VSCode. File location:

• Windows: %APPDATA%\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\cline_mcp_settings.json
• Linux: ~/.config/Code/User/globalStorage\rooveterinaryinc.roo-cline\settings\cline_mcp_settings.json
• macOS: ~/Library/Application Support/Code/User/globalStorage\rooveterinaryinc.roo-cline\settings\cline_mcp_settings.json

Add the following configuration:

{
  "mcpServers": {
    "wecom-bot-server": {
      "command": "wecom-bot-mcp-server",
      "args": [],
      "env": {
        "WECOM_WEBHOOK_URL": "<your WeCom bot webhook URL>"
      },
      "alwaysAllow": [
        "send_message"
      ],
      "disabled": false
    }
  }
}

Configuration notes:

• command: Uses the installed command-line tool
• env.WECOM_WEBHOOK_URL: Replace with your actual WeCom bot webhook URL

Development

1. Clone repository:

git clone https://github.com/loonghao/wecom-bot-mcp-server.git
cd wecom-bot-mcp-server

2. Install poetry and dependencies:

pip install poetry
poetry install --with dev

3. Run tests:

poetry run pytest tests/ --cov=wecom_bot_mcp_server

4. Code checks:

poetry run ruff check .
poetry run ruff format .
poetry run mypy src/wecom_bot_mcp_server --strict

Requirements

• Python >= 3.10
• FastMCP >= 0.4.1
• httpx >= 0.24.1

License

MIT License

Contributing

Issues and Pull Requests are welcome!

---

WeCom Bot MCP Server (中文)

English | 中文

特性

• 基于 FastMCP 框架实现
• 支持 Markdown 格式消息
• 异步消息发送
• 消息历史记录
• 完整的类型提示
• 全面的单元测试

安装

使用 pip 安装：

pip install wecom-bot-mcp-server

或者使用 poetry 安装（推荐）：

poetry add wecom-bot-mcp-server

使用方法

1. 设置环境变量：

# Windows PowerShell
$env:WECOM_WEBHOOK_URL="你的企业微信机器人 Webhook URL"

# Linux/macOS
export WECOM_WEBHOOK_URL="你的企业微信机器人 Webhook URL"

2. 运行服务器：

# 安装后可以直接运行命令
wecom-bot-mcp-server

或者在代码中使用：

from wecom_bot_mcp_server.server import main

# 启动服务器
if __name__ == "__main__":
    main()

3. 发送消息：

from wecom_bot_mcp_server.server import send_message, get_message_history

# 发送消息
await send_message("Hello, WeCom!")

# 获取消息历史
history = get_message_history()

在 Cline 中配置

1. 安装依赖：

poetry add wecom-bot-mcp-server

2. 配置 Cline MCP 设置：

在 VSCode 中，需要配置 Cline MCP 设置文件。文件位置：

• Windows: %APPDATA%\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\cline_mcp_settings.json
• Linux: ~/.config/Code/User/globalStorage\rooveterinaryinc.roo-cline\settings\cline_mcp_settings.json
• macOS: ~/Library/Application Support/Code/User/globalStorage\rooveterinaryinc.roo-cline\settings\cline_mcp_settings.json

添加以下配置：

{
  "mcpServers": {
    "wecom-bot-server": {
      "command": "wecom-bot-mcp-server",
      "args": [],
      "env": {
        "WECOM_WEBHOOK_URL": "<你的企业微信机器人Webhook URL>"
      },
      "alwaysAllow": [
        "send_message"
      ],
      "disabled": false
    }
  }
}

配置说明：

• command: 使用安装后的命令行工具
• env.WECOM_WEBHOOK_URL: 替换为你的企业微信机器人实际的 Webhook URL

开发

1. 克隆仓库：

git clone https://github.com/loonghao/wecom-bot-mcp-server.git
cd wecom-bot-mcp-server

2. 安装 poetry 和依赖：

pip install poetry
poetry install --with dev

3. 运行测试：

poetry run pytest tests/ --cov=wecom_bot_mcp_server

4. 代码检查：

poetry run ruff check .
poetry run ruff format .
poetry run mypy src/wecom_bot_mcp_server --strict

要求

• Python >= 3.10
• FastMCP >= 0.4.1
• httpx >= 0.24.1

许可证

MIT License

贡献

欢迎提交 Issue 和 Pull Request！