WeCom机器人MCP兼容服务器实现

简介

我们开发了一个支持Model Context Protocol（MCP）的WeCom机器人服务器。该服务器能够与主流AI模型进行交互，并通过WeCom企业微信发送消息、文件和图片。

核心功能

• 支持发送多种类型的消息：文本、Markdown格式、文件和图片
• 提供@提及功能，支持批量用户通知
• 内建消息历史记录模块
• 支持本地和远程图片传输
• 提供完整的API接口

安装方法

使用pip安装

pip install wecom-bot-mcp-server

从源码安装

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

快速入门

初始化配置

在config.py文件中添加以下内容：

BOT_TOKEN = "your_bot_token"
API_HOST = "your_api_host"

发送消息示例

from wecom_bot_mcp_server import mcp

# 发送文本消息
await mcp.send_message("这是一条测试信息")

# 发送Markdown格式消息
await mcp.send_message("**重要通知**", msg_type="markdown")

API文档

发送文本消息

async def send_message(message: str, *, msg_type: str = "text", mentioned_list: List[str] = None):
    """
    发送文本或Markdown格式的消息
    
    参数:
        message (str): 消息内容
        msg_type (str, 可选): 消息类型，支持"text"和"markdown"
        mentioned_list (List[str], 可选): 需要@提及的用户ID列表
    返回:
        bool: 发送结果
    """

发送文件

async def send_file(file_path: str):
    """
    上传并发送文件
    
    参数:
        file_path (str): 文件路径，支持本地和远程URL
    返回:
        bool: 发送结果
    """

开发指南

环境搭建

1. 安装依赖：

pip install -r requirements.txt

2. 启动开发服务器：

python src/server.py

测试流程

1. 运行单元测试：

pytest tests/

2. 执行代码检查：

flake8 . --ignore=E501

项目结构

wecom-bot-mcp-server/
├── src/
│   └── wecom_bot_mcp_server/
│       ├── __init__.py
│       ├── server.py
│       ├── message_handler.py
│       └── file_storage.py
└── tests/
    └── test_*.py

许可证

本项目遵循MIT开源协议，详细内容请参阅LICENSE文件。

联系方式

• 作者：longhao
• 邮箱：hal.long@outlook.com