WeCom Bot MCP Server

WeCom Bot MCP Server

site icon
2025.04.16 26
Python企业微信集成消息自动化交流协作
WeCom Bot MCP Server 是一个符合 Model Context Protocol (MCP) 规范的服务器实现,专为企业微信(WeChat Work)机器人设计。它支持多种消息类型,包括文本、Markdown、图片和文件,并提供了消息历史跟踪、可配置的日志系统等功能。
View on GitHub

Overview

基本能力

产品定位

WeCom Bot MCP Server 是一个为企业微信机器人设计的 MCP 兼容服务器,旨在通过标准化的协议实现与企业微信的高效集成。

核心功能

  • 支持多种消息类型:文本、Markdown、图片(base64)、文件
  • 支持通过用户ID或电话号码@提及用户
  • 消息历史跟踪
  • 可配置的日志系统
  • 完整的类型注解
  • 基于 Pydantic 的数据验证

适用场景

  • 企业内部的自动化通知系统
  • 团队协作中的消息自动化发送
  • 集成到现有工作流中作为消息传递组件

工具列表

  • send_message: 发送消息到企业微信
  • send_wecom_file: 发送文件到企业微信
  • send_wecom_image: 发送图片到企业微信

常见问题解答

  • 需要 Python 3.10+ 环境
  • 需要从企业微信群设置中获取 Webhook URL

使用教程

使用依赖

  • Python 3.10+
  • 企业微信机器人 Webhook URL

安装教程

自动化安装(推荐)

npx -y @smithery/cli install wecom-bot-mcp-server --client claude

手动安装

pip install wecom-bot-mcp-server

调试方式

wecom-bot-mcp-server

开发

设置开发环境

git clone https://github.com/loonghao/wecom-bot-mcp-server.git
cd wecom-bot-mcp-server
pip install uv
uv venv
uv pip install -e ".[dev]"

测试

uvx nox -s pytest

代码风格检查

uvx nox -s lint

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。