feishu webhook mcp

# 飞书Webhook消息发送服务

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

## 功能特点

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

## 安装与配置

### 1. 安装依赖

```bash
pip install -r requirements.txt
```

### 2. 配置环境变量

将`.env.example`文件复制为`.env`，并填入您的飞书机器人Webhook URL：

```bash
cp .env.example .env
```

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

### 3. 获取飞书Webhook URL

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

## 使用方法

### 1. 启动服务

```bash
python server.py
```

### 2. 在MCP客户端中配置

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

```json
{
  "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