mcp-feishu

面向大语言模型与智能 Agent 的标准 Model Context Protocol (MCP) Server。

它的作用是为 AI 提供 send_to_feishu 工具，将长文本、运维命令、配置片段等内容以富文本卡片的形式推送到飞书自定义机器人群组中。用户在飞书客户端可以直接一键整段复制命令，无需在终端手动抄写。

特性

• 标准协议支持：基于 Model Context Protocol Python SDK 实现，遵循 MCP 标准规范。
• 零配置中心依赖：纯粹通过环境变量读取参数，不强绑定任何特定主机或配置中心（如 Nacos）。可跨机器无缝迁移部署。
• 即装即用：支持直接通过 uvx mcp-feishu 或 pip install mcp-feishu 启动。
• 安全与防泄露：内置敏感请求日志脱敏机制，确保 Webhook 凭据不打印至终端或日志。
• 富文本排版：飞书交互式卡片渲染，支持 Markdown 与等宽代码块整段复制。

环境变量配置

本服务完全由环境变量控制，无需修改任何代码文件：

快速使用

1. Claude Desktop / Codex 配置 (推荐使用 uvx)

在你的客户端配置文件（如 claude_desktop_config.json 或 ~/.codex/config.toml）中加入配置：

JSON 格式 (Claude Desktop / Cursor 等)

{
  "mcpServers": {
    "feishu": {
      "command": "uvx",
      "args": ["mcp-feishu"],
      "env": {
        "FEISHU_WEBHOOK": "https://open.feishu.cn/open-apis/bot/v2/hook/YOUR_ROBOT_WEBHOOK_KEY",
        "FEISHU_SECRET": "YOUR_SECRET_IF_ENABLED"
      }
    }
  }
}

TOML 格式 (Codex 等)

[mcp_servers.feishu]
type = "stdio"
command = "uvx"
args = ["mcp-feishu"]

[mcp_servers.feishu.env]
FEISHU_WEBHOOK = "https://open.feishu.cn/open-apis/bot/v2/hook/YOUR_ROBOT_WEBHOOK_KEY"
FEISHU_SECRET = "YOUR_SECRET_IF_ENABLED"

2. 通过 pip 安装运行

pip install mcp-feishu
export FEISHU_WEBHOOK="https://open.feishu.cn/open-apis/bot/v2/hook/xxx"
mcp-feishu

提供的工具 (Tools)

send_to_feishu

向指定的飞书群机器人发送通知卡片。

• 参数：
  • text (string, required): 消息正文。支持 Markdown；长命令或代码建议使用 ``` 包裹，以便在客户端整段复制。
  • title (string, optional): 卡片头部标题。留空时使用 FEISHU_TITLE 默认标题。
• 返回：发送状态结果描述（例如 "已送达" 或失败原因）。

开源协议

MIT License