飞书 MCP Server 管理

HTTP API 接口说明

以下 API 可供其他应用直接调用，无需 MCP 协议。基础 URL 即本服务地址。

POST /api/send

发送纯文本消息到飞书群

// 请求体 (JSON)
{
  "text": "消息内容",             // 必填
  "webhookUrl": "https://...",   // 可选，不传则用默认
  "webhookId": "xxx"             // 可选，用已配置的 webhook ID
}

// 成功响应
{
  "ok": true,
  "httpStatus": 200,
  "feishuCode": 0,
  "feishuMsg": "success",
  "raw": "{...}"
}

// curl 示例
curl -X POST http://localhost:3000/api/send \
  -H "Content-Type: application/json" \
  -d '{"text":"Hello from API!"}'

GET /api/webhooks

获取所有已配置的 Webhook 列表

POST /api/webhooks

添加新的 Webhook 配置

// 请求体
{
  "name": "生产群",
  "url": "https://open.feishu.cn/open-apis/bot/v2/hook/xxx",
  "isDefault": true
}

GET /api/history?limit=50

获取发送记录

GET /healthz

健康检查

MCP 协议端点（SSE / Streamable HTTP）

以下端点供 MCP 客户端（如 Notion、Claude Desktop、CodeBuddy 等）直接连接。

GET /sse

建立 SSE 连接（旧版 MCP 传输，Notion 等客户端使用）

// 客户端连接此端点建立 SSE 流
// 服务器返回 endpoint 事件，告知客户端 POST 消息到 /mcp?sessionId=xxx

// 如果配置了 MCP_AUTH_TOKEN，需要携带 Authorization 头
// Authorization: Bearer <your-token>

POST /mcp

MCP 消息端点（兼容 SSE 和 Streamable HTTP 两种模式）

// SSE 模式：POST /mcp?sessionId=xxx
// Streamable HTTP 模式：POST /mcp（带 Mcp-Session-Id 头）

MCP 客户端接入配置

🌐 远程 HTTP 模式（Notion、Web 客户端）

MCP 服务器 URL: https://<你的域名或IP>/sse

验证方式:
  - 未设置 MCP_AUTH_TOKEN → 无需验证
  - 已设置 MCP_AUTH_TOKEN → Bearer Token 验证

💻 本地 stdio 模式（Claude Desktop、Cursor 等）

{
  "mcpServers": {
    "feishu-webhook": {
      "command": "node",
      "args": ["path/to/feishu-mcp-server/dist/index.js"],
      "env": {
        "SERVER_PORT": "3000"
      }
    }
  }
}

🌐 远程 HTTP 模式（Notion、Web 客户端）

💻 本地 stdio 模式（Claude Desktop、Cursor 等）

添加 Webhook