飞书Webhook消息发送服务

April 18, 2025 · View on GitHub

这是一个基于MCP协议的飞书消息发送服务,可以通过Webhook向飞书发送消息。

功能特点

  • 支持发送纯文本消息
  • 支持发送带标题的富文本消息
  • 使用stdio通信模式
  • 简单易用的API接口

安装与配置

1. 安装依赖

pip install -r requirements.txt

2. 配置环境变量

.env.example文件复制为.env,并填入您的飞书机器人Webhook URL:

cp .env.example .env

然后编辑.env文件,填入您的飞书机器人Webhook URL。

3. 获取飞书Webhook URL

  1. 在飞书中创建一个群聊
  2. 添加机器人:在群设置中点击"添加机器人"
  3. 选择"自定义机器人",设置机器人名称和头像
  4. 获取Webhook URL,并填入.env文件中

使用方法

1. 启动服务

python server.py

2. 在MCP客户端中配置

在MCP客户端配置文件中添加以下配置:

{
  "mcpServers": {
    "feishu-webhook": {
      "command": "python",
      "args": [
        "/绝对路径/到/feishu-webhook/server.py"
      ],
      "env": {
        "FEISHU_WEBHOOK_URL": "https://open.feishu.cn/open-apis/bot/v2/hook/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
      }
    }
  }
}

注意:将上述配置中的FEISHU_WEBHOOK_URL替换为您的飞书机器人Webhook URL。

可用工具

1. 发送纯文本消息

send_text_message(content: str)

参数:

  • content: 消息内容

2. 发送带标题的富文本消息

send_rich_message(title: str, content: str)

参数:

  • title: 消息标题
  • content: 消息内容

示例

发送纯文本消息

请发送一条消息到飞书:"今天的会议将在下午3点开始"

发送带标题的富文本消息

请发送一条带标题的消息到飞书,标题为"会议通知",内容为"今天的产品评审会议将在下午3点开始,请准时参加"

故障排除

如果遇到问题,请检查:

  1. 环境变量是否正确设置
  2. 飞书Webhook URL是否有效
  3. 网络连接是否正常

许可证

MIT