WeCom Bot MCP Server

WeCom Bot MCP Server

site icon
2025.02.17 2
Python企业微信机器人消息服务交流协作
WeCom Bot MCP Server 是一个基于 FastMCP 框架实现的企业微信机器人服务,支持通过 webhook 发送消息。该服务提供了消息发送、历史记录查询等功能,并支持 Markdown 格式的消息。
View on GitHub

Overview

基本能力

产品定位

WeCom Bot MCP Server 是一个企业微信机器人服务,旨在通过 webhook 实现消息的发送和管理。

核心功能

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

适用场景

  • 企业内部通知系统
  • 自动化消息推送
  • 团队协作工具集成

工具列表

  • wecom-bot-mcp-server: 主服务工具,用于启动和管理企业微信机器人服务。
  • send_message: 用于发送消息的工具。
  • get_message_history: 用于查询消息历史的工具。

常见问题解答

  • 如何设置 webhook URL? 通过环境变量 WECOM_WEBHOOK_URL 设置。
  • 如何启动服务? 安装后直接运行 wecom-bot-mcp-server 命令。

使用教程

使用依赖

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

安装教程

使用 pip 安装:

pip install wecom-bot-mcp-server

或者使用 poetry 安装(推荐):

poetry add wecom-bot-mcp-server

调试方式

  1. 设置环境变量:
export WECOM_WEBHOOK_URL="你的企业微信机器人 Webhook URL"
  1. 运行服务器:
wecom-bot-mcp-server
  1. 发送消息:
from wecom_bot_mcp_server.server import send_message
await send_message("Hello, WeCom!")

许可证

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