@lmcl/ailo-mcp-feishu 0.0.1

package/dist/index.js

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+import "dotenv/config";
+import { runMcpChannel } from "@lmcl/ailo-mcp-sdk";
+import { FeishuHandler } from "./feishu-handler.js";
+import { createFeishuMcpServer } from "./mcp-server.js";
+const FEISHU_APP_ID = process.env.FEISHU_APP_ID ?? "";
+const FEISHU_APP_SECRET = process.env.FEISHU_APP_SECRET ?? "";
+const FEISHU_DOMAIN = process.env.FEISHU_DOMAIN === "lark" ? "lark" : "feishu";
+if (!FEISHU_APP_ID || !FEISHU_APP_SECRET) {
+    console.error("Missing FEISHU_APP_ID or FEISHU_APP_SECRET");
+    process.exit(1);
+}
+const handler = new FeishuHandler({
+    appId: FEISHU_APP_ID,
+    appSecret: FEISHU_APP_SECRET,
+    domain: FEISHU_DOMAIN,
+});
+handler.setOnBotRemovedFromGroup((chatId) => {
+    console.log("[feishu] bot removed from group", chatId);
+});
+handler.setOnMessageRead(() => { });
+function feishuBuildChannelPrompt() {
+    return `ID 格式：ou_xxx 是飞书用户 ID，oc_xxx 是群组 ID。
+
+@提及：@提及格式为 @显示名(ou_xxx)。使用此格式可触发飞书强提醒。
+
+表情：飞书仅支持 Unicode emoji（😊👍❤️），不支持 :xxx: 冒号格式。
+
+外部用户：昵称为"外部用户N"的是非本组织成员，飞书无法获取其真实姓名。同一编号始终对应同一人。昵称可通过 set_nickname 工具更新。
+
+转发限制：私聊消息只能发给曾与你发起过私聊的用户。`;
+}
+const mcpServer = createFeishuMcpServer(handler);
+runMcpChannel({
+    handler,
+    buildChannelPrompt: feishuBuildChannelPrompt,
+    mcpServer,
+});

package/dist/mcp-server.js

@@ -0,0 +1,93 @@
+/**
+ * 飞书通道 MCP 服务：stdio 传输，暴露飞书特有工具供 AI 直接调用。
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+export function createFeishuMcpServer(handler) {
+    const server = new McpServer({
+        name: "feishu",
+        version: "0.1.0",
+    });
+    server.registerTool("send_message", {
+        description: "向飞书聊天发送消息。chat_id 使用信号中的 chat_id 标签值（ou_xxx 是私聊用户，oc_xxx 是群聊）。",
+        inputSchema: {
+            chat_id: z.string().describe("目标聊天 ID（ou_xxx 私聊 / oc_xxx 群聊）"),
+            text: z.string().describe("消息内容"),
+        },
+    }, async ({ chat_id, text }) => {
+        try {
+            await handler.sendText(chat_id, text);
+            return {
+                content: [{ type: "text", text: `消息已发送到 ${chat_id}` }],
+                isError: false,
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `发送失败: ${err.message}` }],
+                isError: true,
+            };
+        }
+    });
+    server.registerTool("read_doc", {
+        description: "读取飞书云文档内容（含图片引用）。传入文档 URL（如 feishu.cn/docx/xxx）。新版文档中的图片会以 [图片 N](url) 形式返回。",
+        inputSchema: {
+            url: z.string().describe("飞书云文档完整 URL"),
+        },
+    }, async ({ url }) => {
+        const content = await handler.fetchDocRawContent(url);
+        if (content === null) {
+            return {
+                content: [{ type: "text", text: "无法获取文档内容（可能无权限或链接无效）" }],
+                isError: true,
+            };
+        }
+        return {
+            content: [{ type: "text", text: content }],
+            isError: false,
+        };
+    });
+    server.registerTool("set_nickname", {
+        description: "更新飞书用户的昵称映射。用于给外部用户设置可识别的名称。",
+        inputSchema: {
+            sender_id: z.string().describe("飞书用户 open_id（ou_xxx）"),
+            nickname: z.string().describe("新昵称"),
+        },
+    }, async ({ sender_id, nickname }) => {
+        try {
+            await handler.onCommand("set_nickname", { sender_id, nickname });
+            return {
+                content: [{ type: "text", text: `已将 ${sender_id} 的昵称设为 ${nickname}` }],
+                isError: false,
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `设置失败: ${err.message}` }],
+                isError: true,
+            };
+        }
+    });
+    server.registerTool("add_reaction", {
+        description: "给飞书消息贴表情回应。仅支持 Unicode emoji。",
+        inputSchema: {
+            message_id: z.string().describe("消息 ID"),
+            emoji_type: z.string().describe("emoji 标识（如 OK、ThumbsUp、Heart）"),
+        },
+    }, async ({ message_id, emoji_type }) => {
+        try {
+            await handler.onCommand("add_reaction", { message_id, emoji_type });
+            return {
+                content: [{ type: "text", text: `已对消息 ${message_id} 贴上 ${emoji_type}` }],
+                isError: false,
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `贴表情失败: ${err.message}` }],
+                isError: true,
+            };
+        }
+    });
+    return server;
+}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@lmcl/ailo-mcp-feishu",
+  "version": "0.0.1",
+  "description": "Ailo 飞书/Lark 通道 MCP",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "ailo-mcp-feishu": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts"
+  },
+  "dependencies": {
+    "@lmcl/ailo-mcp-sdk": "^0.0.1",
+    "@larksuiteoapi/node-sdk": "^1.56.1",
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "dotenv": "^16.4.5",
+    "form-data": "^4.0.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0"
+  }
+}