feishu-mcp 0.1.5 → 0.1.7

package/dist/mcp/tools/feishuBlockTools.js

@@ -12,7 +12,7 @@ BlockConfigSchema, MediaIdSchema, MediaExtraSchema, ImagesArraySchema,
 // MermaidCodeSchema,
 // ImageWidthSchema,
 // ImageHeightSchema
-TableCreateSchema } from '../../types/feishuSchema.js';
+TableCreateSchema, WhiteboardFillArraySchema } from '../../types/feishuSchema.js';
 /**
  * 注册飞书块相关的MCP工具
  * @param server MCP服务器实例
@@ -47,7 +47,7 @@ export function registerFeishuBlockTools(server, feishuService) {
         }
     });
     // 添加通用飞书块创建工具（支持文本、代码、标题）
-    server.tool('batch_create_feishu_blocks', 'PREFERRED: Efficiently creates multiple blocks (text, code, heading, list) in a single API call. USE THIS TOOL when creating multiple consecutive blocks at the same position - reduces API calls by up to 90%. KEY FEATURES: (1) Handles any number of blocks by auto-batching large requests (>50 blocks), (2) Creates blocks at consecutive positions in a document, (3) Supports direct heading level format (e.g. "heading1", "heading2") or standard "heading" type with level in options. CORRECT FORMAT: mcp_feishu_batch_create_feishu_blocks({documentId:"doc123",parentBlockId:"para123",startIndex:0,blocks:[{blockType:"text",options:{...}},{blockType:"heading1",options:{heading:{content:"Title"}}}]}). For separate positions, use individual block creation tools instead. For wiki links (https://xxx.feishu.cn/wiki/xxx), first convert with convert_feishu_wiki_to_document_id tool.', {
+    server.tool('batch_create_feishu_blocks', 'PREFERRED: Efficiently creates multiple blocks (text, code, heading, list, image, mermaid, whiteboard) in a single API call. USE THIS TOOL when creating multiple consecutive blocks at the same position - reduces API calls by up to 90%. KEY FEATURES: (1) Handles any number of blocks by auto-batching large requests (>50 blocks), (2) Creates blocks at consecutive positions in a document, (3) Supports direct heading level format (e.g. "heading1", "heading2") or standard "heading" type with level in options. CORRECT FORMAT: mcp_feishu_batch_create_feishu_blocks({documentId:"doc123",parentBlockId:"para123",startIndex:0,blocks:[{blockType:"text",options:{...}},{blockType:"heading1",options:{heading:{content:"Title"}}}]}). For whiteboard blocks, use blockType:"whiteboard" with options:{whiteboard:{align:1}}. After creating a whiteboard block, you will receive a token in the response (board.token field) which can be used with fill_whiteboard_with_plantuml tool. The fill_whiteboard_with_plantuml tool supports both PlantUML (syntax_type: 1) and Mermaid (syntax_type: 2) formats. For separate positions, use individual block creation tools instead. For wiki links (https://xxx.feishu.cn/wiki/xxx), first convert with convert_feishu_wiki_to_document_id tool.', {
         documentId: DocumentIdSchema,
         parentBlockId: ParentBlockIdSchema,
         index: IndexSchema,
@@ -110,6 +110,9 @@ export function registerFeishuBlockTools(server, feishuService) {
                 // 检查是否有图片块（block_type=27）
                 const imageBlocks = result.children?.filter((child) => child.block_type === 27) || [];
                 const hasImageBlocks = imageBlocks.length > 0;
+                // 检查是否有画板块（block_type=43）
+                const whiteboardBlocks = result.children?.filter((child) => child.block_type === 43) || [];
+                const hasWhiteboardBlocks = whiteboardBlocks.length > 0;
                 const responseData = {
                     ...result,
                     nextIndex: index + blockContents.length,
@@ -120,6 +123,17 @@ export function registerFeishuBlockTools(server, feishuService) {
                             blockIds: imageBlocks.map((block) => block.block_id),
                             reminder: "检测到图片块已创建！请使用 upload_and_bind_image_to_block 工具上传图片并绑定到对应的块ID。"
                         }
+                    }),
+                    ...(hasWhiteboardBlocks && {
+                        whiteboardBlocksInfo: {
+                            count: whiteboardBlocks.length,
+                            blocks: whiteboardBlocks.map((block) => ({
+                                blockId: block.block_id,
+                                token: block.board?.token,
+                                align: block.board?.align
+                            })),
+                            reminder: "检测到画板块已创建！请使用 fill_whiteboard_with_plantuml 工具填充画板内容，使用返回的 token 作为 whiteboardId 参数。支持 PlantUML (syntax_type: 1) 和 Mermaid (syntax_type: 2) 两种格式。"
+                        }
                     })
                 };
                 return {
@@ -201,12 +215,26 @@ export function registerFeishuBlockTools(server, feishuService) {
                         allImageBlocks.push(...imageBlocks);
                     });
                     const hasImageBlocks = allImageBlocks.length > 0;
-                    const responseText = `所有飞书块创建成功，共分 ${totalBatches} 批创建了 ${createdBlocksCount} 个块。\n\n` +
+                    // 检查所有批次中是否有画板块（block_type=43）
+                    const allWhiteboardBlocks = [];
+                    results.forEach(batchResult => {
+                        const whiteboardBlocks = batchResult.children?.filter((child) => child.block_type === 43) || [];
+                        allWhiteboardBlocks.push(...whiteboardBlocks);
+                    });
+                    const hasWhiteboardBlocks = allWhiteboardBlocks.length > 0;
+                    let responseText = `所有飞书块创建成功，共分 ${totalBatches} 批创建了 ${createdBlocksCount} 个块。\n\n` +
                         `最后一批结果: ${JSON.stringify(results[results.length - 1], null, 2)}\n\n` +
-                        `下一个索引位置: ${currentStartIndex}，总创建块数: ${createdBlocksCount}` +
-                        (hasImageBlocks ? `\n\n⚠️ 检测到 ${allImageBlocks.length} 个图片块已创建！\n` +
+                        `下一个索引位置: ${currentStartIndex}，总创建块数: ${createdBlocksCount}`;
+                    if (hasImageBlocks) {
+                        responseText += `\n\n⚠️ 检测到 ${allImageBlocks.length} 个图片块已创建！\n` +
                             `图片块IDs: ${allImageBlocks.map(block => block.block_id).join(', ')}\n` +
-                            `请使用 upload_and_bind_image_to_block 工具上传图片并绑定到对应的块ID。` : '');
+                            `请使用 upload_and_bind_image_to_block 工具上传图片并绑定到对应的块ID。`;
+                    }
+                    if (hasWhiteboardBlocks) {
+                        responseText += `\n\n⚠️ 检测到 ${allWhiteboardBlocks.length} 个画板块已创建！\n` +
+                            `画板块信息:\n${allWhiteboardBlocks.map((block) => `  - blockId: ${block.block_id}, token: ${block.board?.token || 'N/A'}\n`).join('')}` +
+                            `请使用 fill_whiteboard_with_plantuml 工具填充画板内容，使用返回的 token 作为 whiteboardId 参数。支持 PlantUML (syntax_type: 1) 和 Mermaid (syntax_type: 2) 两种格式。`;
+                    }
                     return {
                         content: [
                             {
@@ -659,4 +687,97 @@ export function registerFeishuBlockTools(server, feishuService) {
             };
         }
     });
+    // 添加批量填充画板工具（支持 PlantUML 和 Mermaid）
+    server.tool('fill_whiteboard_with_plantuml', 'Batch fills multiple whiteboard blocks with diagram content (PlantUML or Mermaid). Use this tool after creating whiteboard blocks with batch_create_feishu_blocks tool. Each item in the array should contain whiteboardId (the token from board.token field), code and syntax_type. Supports both PlantUML (syntax_type: 1) and Mermaid (syntax_type: 2) formats. Returns detailed results including which whiteboards were filled successfully and which failed, along with failure reasons. The same whiteboard can be filled multiple times.', {
+        whiteboards: WhiteboardFillArraySchema,
+    }, async ({ whiteboards }) => {
+        try {
+            if (!feishuService) {
+                return {
+                    content: [{ type: 'text', text: '飞书服务未初始化，请检查配置' }],
+                };
+            }
+            if (!whiteboards || whiteboards.length === 0) {
+                return {
+                    content: [{ type: 'text', text: '错误：画板数组不能为空' }],
+                };
+            }
+            Logger.info(`开始批量填充画板内容，共 ${whiteboards.length} 个画板`);
+            const results = [];
+            let successCount = 0;
+            let failCount = 0;
+            // 逐个处理每个画板
+            for (let i = 0; i < whiteboards.length; i++) {
+                const item = whiteboards[i];
+                const { whiteboardId, code, syntax_type } = item;
+                const syntaxTypeName = syntax_type === 1 ? 'PlantUML' : 'Mermaid';
+                Logger.info(`处理第 ${i + 1}/${whiteboards.length} 个画板，画板ID: ${whiteboardId}，语法类型: ${syntaxTypeName}`);
+                try {
+                    const result = await feishuService.createDiagramNode(whiteboardId, code, syntax_type);
+                    Logger.info(`画板填充成功，画板ID: ${whiteboardId}`);
+                    successCount++;
+                    results.push({
+                        whiteboardId: whiteboardId,
+                        syntaxType: syntaxTypeName,
+                        status: 'success',
+                        nodeId: result.node_id,
+                        result: result
+                    });
+                }
+                catch (error) {
+                    Logger.error(`画板填充失败，画板ID: ${whiteboardId}`, error);
+                    failCount++;
+                    // 提取详细的错误信息
+                    let errorMessage = formatErrorMessage(error);
+                    let errorCode;
+                    let logId;
+                    if (error?.apiError) {
+                        const apiError = error.apiError;
+                        if (apiError.code !== undefined && apiError.msg) {
+                            errorCode = apiError.code;
+                            errorMessage = apiError.msg;
+                            if (apiError.log_id) {
+                                logId = apiError.log_id;
+                            }
+                        }
+                    }
+                    else if (error?.err) {
+                        errorMessage = error.err;
+                    }
+                    else if (error?.message) {
+                        errorMessage = error.message;
+                    }
+                    results.push({
+                        whiteboardId: whiteboardId,
+                        syntaxType: syntaxTypeName,
+                        status: 'failed',
+                        error: {
+                            message: errorMessage,
+                            code: errorCode,
+                            logId: logId,
+                            details: error
+                        }
+                    });
+                }
+            }
+            // 构建返回结果
+            const summary = {
+                total: whiteboards.length,
+                success: successCount,
+                failed: failCount,
+                results: results
+            };
+            Logger.info(`批量填充画板完成，成功: ${successCount}，失败: ${failCount}`);
+            return {
+                content: [{ type: 'text', text: JSON.stringify(summary, null, 2) }],
+            };
+        }
+        catch (error) {
+            Logger.error(`批量填充画板内容失败:`, error);
+            const errorMessage = formatErrorMessage(error);
+            return {
+                content: [{ type: 'text', text: `批量填充画板内容失败: ${errorMessage}\n\n错误详情: ${JSON.stringify(error, null, 2)}` }],
+            };
+        }
+    });
 }

package/dist/server.js

@@ -7,7 +7,7 @@ import { Logger } from './utils/logger.js';
 import { SSEConnectionManager } from './manager/sseConnectionManager.js';
 import { FeishuMcp } from './mcp/feishuMcp.js';
 import { callback } from './services/callbackService.js';
-import { UserAuthManager, UserContextManager, getBaseUrl, TokenCacheManager } from './utils/auth/index.js';
+import { UserAuthManager, UserContextManager, getBaseUrl, TokenCacheManager, TokenRefreshManager } from './utils/auth/index.js';
 export class FeishuMcpServer {
     constructor() {
         Object.defineProperty(this, "connectionManager", {
@@ -33,6 +33,10 @@ export class FeishuMcpServer {
         this.userContextManager = UserContextManager.getInstance();
         // 初始化TokenCacheManager，确保在启动时从文件加载缓存
         TokenCacheManager.getInstance();
+        // 启动Token自动刷新管理器
+        const tokenRefreshManager = TokenRefreshManager.getInstance();
+        tokenRefreshManager.start();
+        Logger.info('Token自动刷新管理器已在服务器启动时初始化');
     }
     async connect(transport) {
         const server = new FeishuMcp();

package/dist/services/baseService.js

@@ -1,7 +1,7 @@
 import axios, { AxiosError } from 'axios';
 import FormData from 'form-data';
 import { Logger } from '../utils/logger.js';
-import { formatErrorMessage, AuthRequiredError } from '../utils/error.js';
+import { formatErrorMessage, AuthRequiredError, ScopeInsufficientError } from '../utils/error.js';
 import { Config } from '../utils/config.js';
 import { TokenCacheManager, UserContextManager, AuthUtils } from '../utils/auth/index.js';
 /**
@@ -126,6 +126,10 @@ export class BaseApiService {
         }
         catch (error) {
             const config = Config.getInstance().feishu;
+            // 优先处理权限不足异常
+            if (error instanceof ScopeInsufficientError) {
+                return this.handleScopeInsufficientError(error);
+            }
             // 处理授权异常
             if (error instanceof AuthRequiredError) {
                 return this.handleAuthFailure(config.authType === "tenant", clientKey, baseUrl, userKey);
@@ -212,6 +216,13 @@ export class BaseApiService {
     async delete(endpoint, data, needsAuth = true) {
         return this.request(endpoint, 'DELETE', data, needsAuth);
     }
+    /**
+     * 处理权限不足异常
+     * @param error 权限不足错误
+     */
+    handleScopeInsufficientError(error) {
+        throw error;
+    }
     /**
      * 处理认证失败
      * @param tenant 是否是tenant
@@ -300,7 +311,7 @@ export class BaseApiService {
         const { appId, appSecret } = Config.getInstance().feishu;
         const clientKey = AuthUtils.generateClientKey(userKey);
         const redirect_uri = `${baseUrl}/callback`;
-        const scope = encodeURIComponent('base:app:read bitable:app bitable:app:readonly board:whiteboard:node:read contact:user.employee_id:readonly docs:document.content:read docx:document docx:document.block:convert docx:document:create docx:document:readonly drive:drive drive:drive:readonly drive:file drive:file:upload sheets:spreadsheet sheets:spreadsheet:readonly space:document:retrieve space:folder:create wiki:space:read wiki:space:retrieve wiki:wiki wiki:wiki:readonly offline_access');
+        const scope = encodeURIComponent('base:app:read bitable:app bitable:app:readonly board:whiteboard:node:read board:whiteboard:node:create contact:user.employee_id:readonly docs:document.content:read docx:document docx:document.block:convert docx:document:create docx:document:readonly drive:drive drive:drive:readonly drive:file drive:file:upload sheets:spreadsheet sheets:spreadsheet:readonly space:document:retrieve space:folder:create wiki:space:read wiki:space:retrieve wiki:wiki wiki:wiki:readonly offline_access');
         const state = AuthUtils.encodeState(appId, appSecret, clientKey, redirect_uri);
         return `https://accounts.feishu.cn/open-apis/authen/v1/authorize?client_id=${appId}&redirect_uri=${encodeURIComponent(redirect_uri)}&scope=${scope}&state=${state}`;
     }

package/dist/services/blockFactory.js

@@ -10,6 +10,7 @@ export var BlockType;
     BlockType["LIST"] = "list";
     BlockType["IMAGE"] = "image";
     BlockType["MERMAID"] = "mermaid";
+    BlockType["WHITEBOARD"] = "whiteboard";
 })(BlockType || (BlockType = {}));
 /**
  * 对齐方式枚举
@@ -78,6 +79,8 @@ export class BlockFactory {
                 return this.createImageBlock(options);
             case BlockType.MERMAID:
                 return this.createMermaidBlock(options);
+            case BlockType.WHITEBOARD:
+                return this.createWhiteboardBlock(options);
             default:
                 Logger.error(`不支持的块类型: ${type}`);
                 throw new Error(`不支持的块类型: ${type}`);
@@ -246,6 +249,20 @@ export class BlockFactory {
             },
         };
     }
+    /**
+     * 创建画板块内容（空画板块，需要后续填充内容）
+     * @param options 画板块选项
+     * @returns 画板块内容对象
+     */
+    createWhiteboardBlock(options = {}) {
+        const { align = AlignType.CENTER } = options;
+        return {
+            block_type: 43, // 43表示画板块
+            board: {
+                align: align // 1 居左，2 居中，3 居右
+            }
+        };
+    }
     /**
      * 创建表格块
      * @param options 表格块选项

package/dist/services/callbackService.js

@@ -74,6 +74,9 @@ export async function callback(req, res) {
             if (data.refresh_token_expires_in) {
                 data.refresh_token_expires_at = Math.floor(Date.now() / 1000) + data.refresh_token_expires_in;
             }
+            // 添加client_id和client_secret，用于后续刷新token
+            data.client_id = appId;
+            data.client_secret = appSecret;
             // 缓存token信息
             const refreshTtl = data.refresh_token_expires_in || 3600 * 24 * 365; // 默认1年
             tokenCacheManager.cacheUserToken(clientKey, data, refreshTtl);