lark-bridge-mcp 1.0.0

package/README.md

@@ -0,0 +1,140 @@
+# lark-mcp-server
+
+飞书/Lark MCP Server —— 通过飞书机器人与用户交互的 Model Context Protocol 工具服务。
+
+## 功能
+
+| 工具 | 说明 |
+|------|------|
+| `ask_user` | 通过飞书发送消息给用户，并等待用户回复（有限次超时重试后返回） |
+| `send_message` | 通过飞书机器人发送消息给用户（不等待回复） |
+
+## 安装
+
+```bash
+npm install -g lark-mcp-server
+```
+
+或直接通过 npx 使用：
+
+```bash
+npx lark-mcp-server
+```
+
+## 快速开始
+
+### 方式一：零配置（推荐新手）
+
+只需要 APP_ID 和 APP_SECRET，首次使用时在飞书私聊机器人发一条消息即可：
+
+```json
+{
+  "mcpServers": {
+    "lark-bridge": {
+      "command": "npx",
+      "args": ["-y", "lark-mcp-server"],
+      "env": {
+        "LARK_APP_ID": "你的 App ID",
+        "LARK_APP_SECRET": "你的 App Secret"
+      }
+    }
+  }
+}
+```
+
+启动后在飞书找到机器人，私聊发一条消息，程序会自动记录你的身份。日志中会打印你的 `open_id`，可以保存下来用于方式二。
+
+### 方式二：固定用户（推荐）
+
+用从方式一获取到的 `open_id` 固定配置，重启后无需再发消息：
+
+```json
+{
+  "mcpServers": {
+    "lark-bridge": {
+      "command": "npx",
+      "args": ["-y", "lark-mcp-server"],
+      "env": {
+        "LARK_APP_ID": "你的 App ID",
+        "LARK_APP_SECRET": "你的 App Secret",
+        "LARK_RECEIVE_ID": "ou_xxxxxxxxxxxxxx",
+        "LARK_RECEIVE_ID_TYPE": "open_id"
+      }
+    }
+  }
+}
+```
+
+### 方式三：邮箱/手机号查找用户
+
+如果飞书应用开通了通讯录权限（`contact:user.email:readonly` 或 `contact:user.phone:readonly`），可以直接用邮箱或手机号：
+
+```json
+"env": {
+  "LARK_APP_ID": "你的 App ID",
+  "LARK_APP_SECRET": "你的 App Secret",
+  "LARK_RECEIVE_ID": "your@company.com",
+  "LARK_RECEIVE_ID_TYPE": "email"
+}
+```
+
+```json
+"env": {
+  "LARK_APP_ID": "你的 App ID",
+  "LARK_APP_SECRET": "你的 App Secret",
+  "LARK_RECEIVE_ID": "13800138000",
+  "LARK_RECEIVE_ID_TYPE": "mobile"
+}
+```
+
+## 环境变量
+
+| 变量 | 必填 | 说明 |
+|------|------|------|
+| `LARK_APP_ID` | ✅ | 飞书应用的 App ID |
+| `LARK_APP_SECRET` | ✅ | 飞书应用的 App Secret |
+| `LARK_RECEIVE_ID` | 可选 | 消息接收者标识 |
+| `LARK_RECEIVE_ID_TYPE` | 可选 | ID 类型：`open_id`/`user_id`/`union_id`/`chat_id`/`email`/`mobile`，不填则自动推断 |
+| `LARK_ENCRYPT_KEY` | 可选 | 事件加密密钥（长连接模式通常不需要） |
+| `LARK_ASK_TIMEOUT_MINUTES` | 可选 | ask_user 单次等待超时（分钟），默认 `5` |
+| `LARK_ASK_MAX_RETRIES` | 可选 | ask_user 超时后最大提醒次数，默认 `2` |
+| `LARK_COLLECT_WINDOW_SECONDS` | 可选 | 收到回复后的收集窗口（秒），默认 `3` |
+| `LARK_MESSAGE_PREFIX` | 可选 | 发送消息前缀，默认 `📢 Cursor 任务同步:\n` |
+
+## 飞书应用配置
+
+1. 前往 [飞书开放平台](https://open.feishu.cn/app/) 创建自建应用
+2. 获取 App ID 和 App Secret
+3. 添加「机器人」能力
+4. 在「权限管理」中开通权限：
+   - **必须**：`im:message`（获取与发送单聊、群组消息）
+   - **必须**：`im:message.p2p_msg:readonly`（获取用户发给机器人的单聊消息）
+   - *可选*：`contact:user.email:readonly`（通过邮箱查找用户，方式三需要）
+   - *可选*：`contact:user.phone:readonly`（通过手机号查找用户，方式三需要）
+5. 在「事件与回调」中选择「使用长连接」，添加 `im.message.receive_v1` 事件
+6. 在「版本管理与发布」中发布应用
+
+## 工作原理
+
+```
+┌──────────────────────────────────────────────────────┐
+│                   lark-mcp-server                    │
+│                                                      │
+│  ┌─────────────────────┐  ┌──────────────────────┐  │
+│  │  Lark WebSocket     │  │  MCP Server (stdio)  │  │
+│  │  长连接 (接收消息)   │  │  ask_user            │  │
+│  │                     │  │  send_message         │  │
+│  └────────┬────────────┘  └──────────┬───────────┘  │
+│           │    消息队列 (bridge)      │              │
+│           └──────────────────────────┘              │
+│                                                      │
+│  ┌─────────────────────┐                            │
+│  │  Lark Client API    │                            │
+│  │  (机器人发送消息)    │                            │
+│  └─────────────────────┘                            │
+└──────────────────────────────────────────────────────┘
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,263 @@
+#!/usr/bin/env node
+// Lark SDK 内部用 console.log 输出日志，会污染 MCP 的 stdio 通道，
+// 必须在加载 SDK 之前将 console.log 重定向到 stderr
+const _originalLog = console.log;
+console.log = (...args) => console.error(...args);
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import * as Lark from "@larksuiteoapi/node-sdk";
+import { z } from "zod";
+// ── 环境变量 ──────────────────────────────────────────────
+const LARK_APP_ID = process.env.LARK_APP_ID ?? "";
+const LARK_APP_SECRET = process.env.LARK_APP_SECRET ?? "";
+const LARK_ENCRYPT_KEY = process.env.LARK_ENCRYPT_KEY ?? "";
+const LARK_RECEIVE_ID_TYPE = process.env.LARK_RECEIVE_ID_TYPE ?? "";
+const LARK_RECEIVE_ID = process.env.LARK_RECEIVE_ID ?? "";
+const WAIT_TIMEOUT_SECONDS = Number(process.env.LARK_WAIT_TIMEOUT_SECONDS ?? "60");
+const COLLECT_WINDOW_SECONDS = Number(process.env.LARK_COLLECT_WINDOW_SECONDS ?? "3");
+const MESSAGE_PREFIX = process.env.LARK_MESSAGE_PREFIX ?? "📢 Cursor 任务同步:\n";
+// ── Lark Client ──────────────────────────────────────────
+const larkClient = new Lark.Client({
+    appId: LARK_APP_ID,
+    appSecret: LARK_APP_SECRET,
+    appType: Lark.AppType.SelfBuild,
+    domain: Lark.Domain.Feishu,
+});
+let resolvedTarget = null;
+let autoOpenId = "";
+async function resolveEmailToOpenId(email) {
+    try {
+        const res = await larkClient.contact.user.batchGetId({
+            params: { user_id_type: "open_id" },
+            data: { emails: [email] },
+        });
+        const users = res.data?.user_list;
+        if (users && users.length > 0 && users[0].user_id) {
+            console.error(`[LarkBridge] 邮箱 ${email} → open_id: ${users[0].user_id}`);
+            return users[0].user_id;
+        }
+        console.error(`[LarkBridge] 邮箱 ${email} 未找到对应用户`);
+        return null;
+    }
+    catch (e) {
+        console.error("[LarkBridge] 通过邮箱查找用户失败:", e);
+        return null;
+    }
+}
+async function resolveMobileToOpenId(mobile) {
+    try {
+        const res = await larkClient.contact.user.batchGetId({
+            params: { user_id_type: "open_id" },
+            data: { mobiles: [mobile] },
+        });
+        const users = res.data?.user_list;
+        if (users && users.length > 0 && users[0].user_id) {
+            console.error(`[LarkBridge] 手机号 ${mobile} → open_id: ${users[0].user_id}`);
+            return users[0].user_id;
+        }
+        console.error(`[LarkBridge] 手机号 ${mobile} 未找到对应用户`);
+        return null;
+    }
+    catch (e) {
+        console.error("[LarkBridge] 通过手机号查找用户失败:", e);
+        return null;
+    }
+}
+async function initSendTarget() {
+    if (!LARK_RECEIVE_ID) {
+        console.error("[LarkBridge] 未配置 LARK_RECEIVE_ID，将自动从收到的消息中获取发送目标");
+        return;
+    }
+    const idType = LARK_RECEIVE_ID_TYPE || "auto";
+    if (idType === "open_id" || idType === "user_id" || idType === "union_id" || idType === "chat_id") {
+        resolvedTarget = { receiveIdType: idType, receiveId: LARK_RECEIVE_ID };
+        console.error(`[LarkBridge] 发送目标: ${idType}=${LARK_RECEIVE_ID}`);
+        return;
+    }
+    if (idType === "email" || (idType === "auto" && LARK_RECEIVE_ID.includes("@"))) {
+        const openId = await resolveEmailToOpenId(LARK_RECEIVE_ID);
+        if (openId) {
+            resolvedTarget = { receiveIdType: "open_id", receiveId: openId };
+            return;
+        }
+        console.error("[LarkBridge] 邮箱解析失败，将尝试自动从消息中获取目标");
+        return;
+    }
+    if (idType === "mobile" || (idType === "auto" && /^\+?\d{7,}$/.test(LARK_RECEIVE_ID))) {
+        const openId = await resolveMobileToOpenId(LARK_RECEIVE_ID);
+        if (openId) {
+            resolvedTarget = { receiveIdType: "open_id", receiveId: openId };
+            return;
+        }
+        console.error("[LarkBridge] 手机号解析失败，将尝试自动从消息中获取目标");
+        return;
+    }
+    console.error(`[LarkBridge] 无法识别 LARK_RECEIVE_ID_TYPE="${idType}"，尝试作为 open_id 使用`);
+    resolvedTarget = { receiveIdType: "open_id", receiveId: LARK_RECEIVE_ID };
+}
+function getSendTarget() {
+    if (resolvedTarget)
+        return resolvedTarget;
+    if (autoOpenId)
+        return { receiveIdType: "open_id", receiveId: autoOpenId };
+    return null;
+}
+let waitingResolve = null;
+const messageQueue = [];
+function pushMessage(content) {
+    if (waitingResolve) {
+        const resolve = waitingResolve;
+        waitingResolve = null;
+        resolve(content);
+    }
+    else {
+        messageQueue.push(content);
+    }
+}
+function pullMessage(timeoutMs) {
+    if (messageQueue.length > 0) {
+        return Promise.resolve(messageQueue.shift());
+    }
+    return new Promise((resolve) => {
+        const timer = setTimeout(() => {
+            waitingResolve = null;
+            resolve(null);
+        }, timeoutMs);
+        waitingResolve = (value) => {
+            clearTimeout(timer);
+            resolve(value);
+        };
+    });
+}
+// ── 通过机器人 API 发送消息 ──────────────────────────────
+async function sendLarkMessage(text) {
+    const target = getSendTarget();
+    if (!target) {
+        console.error("[LarkBridge] 无发送目标！请先在飞书给机器人发一条消息，或配置 LARK_RECEIVE_ID");
+        return;
+    }
+    try {
+        const res = await larkClient.im.message.create({
+            params: { receive_id_type: target.receiveIdType },
+            data: {
+                receive_id: target.receiveId,
+                content: JSON.stringify({ text: `${MESSAGE_PREFIX}${text}` }),
+                msg_type: "text",
+            },
+        });
+        if (res.code === 0) {
+            console.error(`[LarkBridge] 消息已发送`);
+        }
+        else {
+            console.error(`[LarkBridge] 发送失败: code=${res.code}, msg=${res.msg}`);
+        }
+    }
+    catch (e) {
+        console.error(`[LarkBridge] 发送飞书消息异常: ${e?.message ?? e}`);
+    }
+}
+// ── 等待/检查用户回复 ────────────────────────────────────
+async function waitForReply(timeoutMs) {
+    const collectMs = COLLECT_WINDOW_SECONDS * 1000;
+    const first = await pullMessage(timeoutMs);
+    if (first === null)
+        return null;
+    console.error(`[LarkBridge] 收到回复: ${first}`);
+    const messages = [first];
+    let next;
+    while ((next = await pullMessage(collectMs)) !== null) {
+        console.error(`[LarkBridge] 收到后续: ${next}`);
+        messages.push(next);
+    }
+    return messages.join("\n");
+}
+// ── 飞书 WebSocket 长连接 ────────────────────────────────
+function startLarkConnection() {
+    if (!LARK_APP_ID || !LARK_APP_SECRET) {
+        console.error("[LarkBridge] LARK_APP_ID 或 LARK_APP_SECRET 未配置，跳过启动");
+        return;
+    }
+    const eventDispatcher = new Lark.EventDispatcher(LARK_ENCRYPT_KEY ? { encryptKey: LARK_ENCRYPT_KEY } : {}).register({
+        "im.message.receive_v1": async (data) => {
+            console.error("[LarkBridge] ====== 收到飞书消息事件 ======");
+            try {
+                const msg = data.message;
+                const sender = data.sender;
+                console.error(`[LarkBridge] 消息ID: ${msg.message_id}`);
+                console.error(`[LarkBridge] chat_id: ${msg.chat_id}, type: ${msg.chat_type}`);
+                console.error(`[LarkBridge] 内容: ${msg.content}`);
+                const senderOpenId = sender?.sender_id?.open_id;
+                if (senderOpenId && !resolvedTarget) {
+                    autoOpenId = senderOpenId;
+                    console.error(`[LarkBridge] ✅ 已自动记录发送者 open_id: ${senderOpenId}`);
+                    console.error(`[LarkBridge] 💡 如需固定配置，可将以下内容添加到 MCP env：`);
+                    console.error(`[LarkBridge]    "LARK_RECEIVE_ID": "${senderOpenId}"`);
+                    console.error(`[LarkBridge]    "LARK_RECEIVE_ID_TYPE": "open_id"`);
+                }
+                let textContent = msg.content;
+                try {
+                    const parsed = JSON.parse(msg.content);
+                    if (parsed.text) {
+                        textContent = parsed.text;
+                    }
+                }
+                catch {
+                    // content 不是 JSON，直接使用原始内容
+                }
+                pushMessage(textContent);
+            }
+            catch (e) {
+                console.error("[LarkBridge] 处理消息异常:", e);
+            }
+        },
+    });
+    const wsClient = new Lark.WSClient({
+        appId: LARK_APP_ID,
+        appSecret: LARK_APP_SECRET,
+        loggerLevel: Lark.LoggerLevel.error,
+    });
+    wsClient.start({ eventDispatcher });
+    console.error("[LarkBridge] Lark WebSocket 长连接已启动");
+}
+// ── MCP Server ───────────────────────────────────────────
+async function main() {
+    startLarkConnection();
+    await initSendTarget();
+    const server = new McpServer({
+        name: "lark-bridge",
+        version: "1.0.0",
+    });
+    server.tool("send_message", "通过飞书机器人发送消息给用户（立即返回，不等待回复）", { message: z.string().describe("要发送给用户的消息内容") }, async ({ message }) => {
+        await sendLarkMessage(message);
+        return { content: [{ type: "text", text: "消息已发送" }] };
+    });
+    server.tool("ask_user", "通过飞书向用户提问并等待回复。传入 prompt 会先发送消息再等待；prompt 为空则仅检查是否有新回复（用于轮询模式）。等待超时后返回 waiting 状态，不会打扰用户。", {
+        prompt: z.string().default("").describe("要发送给用户的消息。为空则不发送，仅检查待处理回复"),
+        timeout_seconds: z.number().default(0).describe("等待超时秒数，0 表示使用默认值"),
+    }, async ({ prompt: promptText, timeout_seconds }) => {
+        if (promptText) {
+            messageQueue.length = 0;
+            waitingResolve = null;
+            await sendLarkMessage(promptText);
+        }
+        const timeout = (timeout_seconds > 0 ? timeout_seconds : WAIT_TIMEOUT_SECONDS) * 1000;
+        const reply = await waitForReply(timeout);
+        if (reply !== null) {
+            return { content: [{ type: "text", text: reply }] };
+        }
+        return {
+            content: [{
+                    type: "text",
+                    text: "[waiting] 用户尚未回复。请稍后再调用 ask_user（prompt 留空）检查新回复，不要重复发送消息打扰用户。",
+                }],
+        };
+    });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("[LarkBridge] MCP Server (stdio) 已就绪");
+}
+main().catch((e) => {
+    console.error("[LarkBridge] 启动失败:", e);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "lark-bridge-mcp",
+  "version": "1.0.0",
+  "description": "飞书/Lark MCP Server - 通过飞书机器人与用户交互的 MCP 工具服务",
+  "keywords": [
+    "mcp",
+    "lark",
+    "feishu",
+    "飞书",
+    "bot",
+    "model-context-protocol"
+  ],
+  "author": "",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "lark-bridge-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@larksuiteoapi/node-sdk": "^1.59.0",
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}