MCP 发送至飞书服务器

English | 中文

一个 MCP 服务器，用于在代理任务完成后向飞书和 WebSocket 发送通知。

特性

• 任务完成后向飞书 webhook 发送通知
• 向 WebSocket 服务器发送通知
• 将所有通知记录到本地文件
• 基于标准 MCP 协议，与各种 LLM 客户端集成

安装

使用 uv 包管理器安装

git clone https://github.com/byom/mcp_server_send_to_feishu.git
cd mcp_server_send_to_feishu

uv venv
source .venv/Scripts/activate

uv pip install mcp-server-send-to-feishu
# or
pip install mcp-server-send-to-feishu

安装完成后，直接调用该模块以检查安装是否成功：

python -m mcp_server_send_to_feishu

该模块接受 --debug 或 --file 选项，我们可以这样使用它：

python -m mcp_server_send_to_feishu --debug
python -m mcp_server_send_to_feishu --debug --log-file=path/to/logfile.log

配置

飞书 Webhook

服务器预配置了一个飞书 webhook URL：

https://www.feishu.cn/***

WebSocket 服务器

默认情况下，服务器连接到：

ws://localhost:8765

使用

与 Claude Desktop 一起使用：

找到配置文件 claude_desktop_config.json

{
    "mcpServers": {
        "NotificationServer": {
            "command": "uv",
            "args": [
              "--directory",
              "path/to/your/mcp_server_send_to_feishu project",
              "run",
              "mcp-server-send-to-feishu",
            ]
        }
    }
}

如果全局安装，您也可以使用 python 命令：

{
    "mcpServers": {
        "NotificationServer": {
            "command": "python",
            "args": [
              "-m",
              "mcp_server_send_to_feishu",
            ]
        }
    }
}

与 Cursor 一起使用：

找到配置文件 ~/.cursor/mcp.json 或 your_project/.cursor/mcp.json

{
    "mcpServers": {
        "NotificationServer": {
            "command": "uv",
            "args": [
              "--directory",
              "path/to/your/mcp_server_send_to_feishu project",
              "run",
              "mcp-server-send-to-feishu",
            ]
        }
    }
}

配置完成后，只需在任务输入的末尾添加类似 finally, send me a notification when task finished. 的提示，即可触发 AI 发送通知。

在 Cursor 中，您可以将此提示作为规则添加到 Cursor Settings -> Rules 中，这样您就不必每次都手动输入它。

通知格式

飞书 Webhook

{
    "msg_type": "text",
    "content": {
        "text": "title\nmessage"
    }
}

WebSocket

{
    "type": "notification",
    "title": "title",
    "message": "message"
}

本地日志文件

通知以 JSON 格式记录到 notifications.log 中：

{
    "title": "title",
    "message": "message",
    "timestamp": "2024-04-14 12:34:56.789012"
}

许可证

MIT

贡献

欢迎提交 Issues 和 Pull Requests！