feishu-mcp 0.0.5 → 0.0.6

package/dist/server.js

@@ -11,126 +11,6 @@ export const Logger = {
         console.error(...args);
     },
 };
-// 添加一个工具类方法，用于格式化错误信息
-function formatErrorMessage(error) {
-    if (error instanceof Error) {
-        return error.message;
-    }
-    else if (typeof error === 'string') {
-        return error;
-    }
-    else if (error && typeof error === 'object') {
-        try {
-            // 处理包含apiError字段的FeishuError对象
-            if (error.apiError) {
-                const apiError = error.apiError;
-                let errorMsg = '';
-                // 处理标准飞书API错误格式
-                if (apiError.code && apiError.msg) {
-                    errorMsg = `${apiError.msg} (错误码: ${apiError.code})`;
-                    // 添加字段验证错误信息
-                    if (apiError.error && apiError.error.field_violations && apiError.error.field_violations.length > 0) {
-                        const violations = apiError.error.field_violations;
-                        errorMsg += '\n字段验证错误:';
-                        violations.forEach((violation) => {
-                            let detail = `\n - ${violation.field}`;
-                            if (violation.description) {
-                                detail += `: ${violation.description}`;
-                            }
-                            if (violation.value) {
-                                detail += `，提供的值: ${violation.value}`;
-                            }
-                            errorMsg += detail;
-                        });
-                        // 添加排查建议链接
-                        if (apiError.error.troubleshooter) {
-                            errorMsg += `\n\n${apiError.error.troubleshooter}`;
-                        }
-                    }
-                    return errorMsg;
-                }
-                // 如果apiError没有标准结构，尝试序列化
-                return `API错误: ${JSON.stringify(apiError)}`;
-            }
-            // 处理飞书API特定的错误格式
-            if (error.code && error.msg) {
-                // 基本错误信息
-                let errorMsg = `${error.msg} (错误码: ${error.code})`;
-                // 如果有详细的验证错误信息
-                if (error.error && error.error.field_violations && error.error.field_violations.length > 0) {
-                    const violations = error.error.field_violations;
-                    errorMsg += '\n字段验证错误:';
-                    violations.forEach((violation) => {
-                        let detail = `\n - ${violation.field}`;
-                        if (violation.description) {
-                            detail += `: ${violation.description}`;
-                        }
-                        if (violation.value) {
-                            detail += `，提供的值: ${violation.value}`;
-                        }
-                        errorMsg += detail;
-                    });
-                    // 添加排查建议链接（如果有）
-                    if (error.error.troubleshooter) {
-                        errorMsg += `\n\n${error.error.troubleshooter}`;
-                    }
-                }
-                return errorMsg;
-            }
-            // 处理 {status, err} 格式的错误
-            if (error.status && error.err) {
-                return `操作失败 (状态码: ${error.status}): ${error.err}`;
-            }
-            // 尝试提取API错误信息，通常在错误对象的message或error字段中
-            if (error.message) {
-                return error.message;
-            }
-            else if (error.error) {
-                if (typeof error.error === 'string') {
-                    return error.error;
-                }
-                else if (error.error.message) {
-                    return error.error.message;
-                }
-                else if (error.error.field_violations) {
-                    // 处理错误嵌套在error对象中的情况
-                    const violations = error.error.field_violations;
-                    let errorMsg = '字段验证错误:';
-                    violations.forEach((violation) => {
-                        let detail = `\n - ${violation.field}`;
-                        if (violation.description) {
-                            detail += `: ${violation.description}`;
-                        }
-                        if (violation.value) {
-                            detail += `，提供的值: ${violation.value}`;
-                        }
-                        errorMsg += detail;
-                    });
-                    return errorMsg;
-                }
-            }
-            else if (error.code || error.status) {
-                // 处理HTTP错误或API错误码
-                const code = error.code || error.status;
-                const msg = error.statusText || error.msg || 'Unknown error';
-                return `操作失败 (错误码: ${code}): ${msg}`;
-            }
-            // 如果上述都不符合，尝试将整个对象序列化（但移除敏感信息）
-            const safeError = { ...error };
-            // 移除可能的敏感信息
-            ['token', 'secret', 'password', 'key', 'credentials'].forEach(key => {
-                if (key in safeError)
-                    delete safeError[key];
-            });
-            return `发生错误: ${JSON.stringify(safeError)}`;
-        }
-        catch (e) {
-            console.error("Error formatting error message:", e);
-            return '发生未知错误';
-        }
-    }
-    return '发生未知错误';
-}
 export class FeishuMcpServer {
     constructor(feishuConfig) {
         Object.defineProperty(this, "server", {
@@ -174,63 +54,77 @@ export class FeishuMcpServer {
     }
     registerTools() {
         // 添加创建飞书文档工具
-        this.server.tool('create_feishu_document', 'Creates a new Feishu document and returns its information. Use this tool when you need to create a document from scratch with a specific title and folder location.', {
-            title: z.string().describe('Document title (required). This will be displayed in the Feishu document list and document header.'),
-            folderToken: z.string().describe('Folder token (required). Specifies where to create the document. Format is an alphanumeric string like "doxcnOu1ZKYH4RtX1Y5XwL5WGRh".'),
+        this.server.tool('create_feishu_doc', 'Create a new Feishu document', {
+            title: z.string().describe('Document title'),
+            folderToken: z
+                .string()
+                .optional()
+                .describe('Folder token where the document will be created. If not provided, the document will be created in the root directory'),
         }, async ({ title, folderToken }) => {
             try {
-                Logger.log(`开始创建飞书文档，标题: ${title}${folderToken ? `，文件夹Token: ${folderToken}` : '，使用默认文件夹'}`);
-                const newDoc = await this.feishuService?.createDocument(title, folderToken);
-                if (!newDoc) {
-                    throw new Error('创建文档失败，未返回文档信息');
-                }
-                Logger.log(`飞书文档创建成功，文档ID: ${newDoc.objToken || newDoc.document_id}`);
+                Logger.log(`开始创建飞书文档，标题: ${title}${folderToken ? `，文件夹Token: ${folderToken}` : ''}`);
+                // @ts-ignore
+                const newDoc = await this.feishuService.createDocument(title, folderToken);
+                Logger.log(`飞书文档创建成功，文档ID: ${newDoc?.objToken || newDoc?.document_id}`);
                 return {
                     content: [{ type: 'text', text: JSON.stringify(newDoc, null, 2) }],
                 };
             }
             catch (error) {
                 Logger.error(`创建飞书文档失败:`, error);
-                const errorMessage = formatErrorMessage(error);
                 return {
-                    content: [{ type: 'text', text: `创建飞书文档失败: ${errorMessage}` }],
+                    content: [{ type: 'text', text: `创建飞书文档失败: ${error}` }],
                 };
             }
         });
         // 添加获取飞书文档信息工具
-        this.server.tool("get_feishu_doc_info", "Retrieves basic information about a Feishu document. Use this to verify if a document exists, check access permissions, or get metadata like title, type, and creation information.", {
-            documentId: z.string().describe("Document ID or URL (required). Supports the following formats:\n1. Standard document URL: https://xxx.feishu.cn/docs/xxx or https://xxx.feishu.cn/docx/xxx\n2. API URL: https://open.feishu.cn/open-apis/doc/v2/documents/xxx\n3. Direct document ID: e.g., JcKbdlokYoPIe0xDzJ1cduRXnRf"),
-        }, async ({ documentId }) => {
-            try {
-                if (!this.feishuService) {
-                    return {
-                        content: [{ type: "text", text: "Feishu service is not initialized. Please check the configuration" }],
-                    };
-                }
-                Logger.log(`开始获取飞书文档信息，文档ID: ${documentId}`);
-                const docInfo = await this.feishuService.getDocumentInfo(documentId);
-                Logger.log(`飞书文档信息获取成功，标题: ${docInfo.title}`);
-                return {
-                    content: [{ type: "text", text: JSON.stringify(docInfo, null, 2) }],
-                };
-            }
-            catch (error) {
-                Logger.error(`获取飞书文档信息失败:`, error);
-                const errorMessage = formatErrorMessage(error);
-                return {
-                    content: [{ type: "text", text: `获取飞书文档信息失败: ${errorMessage}` }],
-                };
-            }
-        });
+        // this.server.tool(
+        //   "get_feishu_doc_info",
+        //   "Get basic information about a Feishu document",
+        //   {
+        //     documentId: z.string().describe("Document ID or URL. Supported formats:\n1. Standard document URL: https://xxx.feishu.cn/docs/xxx or https://xxx.feishu.cn/docx/xxx\n2. API URL: https://open.feishu.cn/open-apis/doc/v2/documents/xxx\n3. Direct document ID (e.g., JcKbdlokYoPIe0xDzJ1cduRXnRf)"),
+        //   },
+        //   async ({ documentId }) => {
+        //     try {
+        //       if (!this.feishuService) {
+        //         return {
+        //           content: [{ type: "text", text: "Feishu service is not initialized. Please check the configuration" }],
+        //         };
+        //       }
+        //       Logger.log(`开始获取飞书文档信息，文档ID: ${documentId}`);
+        //       const docInfo = await this.feishuService.getDocumentInfo(documentId);
+        //       Logger.log(`飞书文档信息获取成功，标题: ${docInfo.title}`);
+        //       return {
+        //         content: [{ type: "text", text: JSON.stringify(docInfo, null, 2) }],
+        //       };
+        //     } catch (error) {
+        //       Logger.error(`获取飞书文档信息失败:`, error);
+        //       return {
+        //         content: [{ type: "text", text: `获取飞书文档信息失败: ${error}` }],
+        //       };
+        //     }
+        //   },
+        // );
         // 添加获取飞书文档内容工具
-        this.server.tool('get_feishu_doc_content', 'Retrieves the plain text content of a Feishu document. Ideal for content analysis, processing, or when you need to extract text without formatting. The content maintains the document structure but without styling.', {
-            documentId: z.string().describe('Document ID or URL (required). Supports the following formats:\n1. Standard document URL: https://xxx.feishu.cn/docs/xxx or https://xxx.feishu.cn/docx/xxx\n2. API URL: https://open.feishu.cn/open-apis/doc/v2/documents/xxx\n3. Direct document ID: e.g., JcKbdlokYoPIe0xDzJ1cduRXnRf'),
-            lang: z.number().optional().default(0).describe('Language code (optional). Default is 0 (Chinese). Use 1 for English if available.'),
+        this.server.tool('get_feishu_doc_content', 'Get the plain text content of a Feishu document', {
+            documentId: z
+                .string()
+                .describe('Document ID or URL. Supported formats:\n1. Standard document URL: https://xxx.feishu.cn/docs/xxx or https://xxx.feishu.cn/docx/xxx\n2. API URL: https://open.feishu.cn/open-apis/doc/v2/documents/xxx\n3. Direct document ID (e.g., JcKbdlokYoPIe0xDzJ1cduRXnRf)'),
+            lang: z
+                .number()
+                .optional()
+                .default(0)
+                .describe('Language code. Default is 0 (Chinese)'),
         }, async ({ documentId, lang }) => {
             try {
                 if (!this.feishuService) {
                     return {
-                        content: [{ type: 'text', text: 'Feishu service is not initialized. Please check the configuration' }],
+                        content: [
+                            {
+                                type: 'text',
+                                text: 'Feishu service is not initialized. Please check the configuration',
+                            },
+                        ],
                     };
                 }
                 Logger.log(`开始获取飞书文档内容，文档ID: ${documentId}，语言: ${lang}`);
@@ -242,21 +136,31 @@ export class FeishuMcpServer {
             }
             catch (error) {
                 Logger.error(`获取飞书文档内容失败:`, error);
-                const errorMessage = formatErrorMessage(error);
                 return {
-                    content: [{ type: 'text', text: `获取飞书文档内容失败: ${errorMessage}` }],
+                    content: [{ type: 'text', text: `获取飞书文档内容失败: ${error}` }],
                 };
             }
         });
         // 添加获取飞书文档块工具
-        this.server.tool('get_feishu_doc_blocks', 'Retrieves the block structure information of a Feishu document. Essential to use before inserting content to understand document structure and determine correct insertion positions. Returns a detailed hierarchy of blocks with their IDs, types, and content.', {
-            documentId: z.string().describe('Document ID or URL (required). Supports the following formats:\n1. Standard document URL: https://xxx.feishu.cn/docs/xxx or https://xxx.feishu.cn/docx/xxx\n2. API URL: https://open.feishu.cn/open-apis/doc/v2/documents/xxx\n3. Direct document ID: e.g., JcKbdlokYoPIe0xDzJ1cduRXnRf'),
-            pageSize: z.number().optional().default(500).describe('Number of blocks per page (optional). Default is 500. Used for paginating large documents. Increase for more blocks at once, decrease for faster response with fewer blocks.'),
+        this.server.tool('get_feishu_doc_blocks', 'When document structure is needed, obtain the block information about the Feishu document for content analysis or block insertion', {
+            documentId: z
+                .string()
+                .describe('Document ID or URL. Supported formats:\n1. Standard document URL: https://xxx.feishu.cn/docs/xxx or https://xxx.feishu.cn/docx/xxx\n2. API URL: https://open.feishu.cn/open-apis/doc/v2/documents/xxx\n3. Direct document ID (e.g., JcKbdlokYoPIe0xDzJ1cduRXnRf)'),
+            pageSize: z
+                .number()
+                .optional()
+                .default(500)
+                .describe('Number of blocks per page. Default is 500'),
         }, async ({ documentId, pageSize }) => {
             try {
                 if (!this.feishuService) {
                     return {
-                        content: [{ type: 'text', text: 'Feishu service is not initialized. Please check the configuration' }],
+                        content: [
+                            {
+                                type: 'text',
+                                text: 'Feishu service is not initialized. Please check the configuration',
+                            },
+                        ],
                     };
                 }
                 Logger.log(`开始获取飞书文档块，文档ID: ${documentId}，页大小: ${pageSize}`);
@@ -268,136 +172,281 @@ export class FeishuMcpServer {
             }
             catch (error) {
                 Logger.error(`获取飞书文档块失败:`, error);
-                const errorMessage = formatErrorMessage(error);
                 return {
-                    content: [{ type: 'text', text: `获取飞书文档块失败: ${errorMessage}` }],
+                    content: [{ type: 'text', text: `获取飞书文档块失败: ${error}` }],
                 };
             }
         });
-        // 添加获取块内容工具
-        this.server.tool('get_feishu_block_content', 'Retrieves the detailed content and structure of a specific block in a Feishu document. Useful for inspecting block properties, formatting, and content, especially before making updates or for debugging purposes.', {
-            documentId: z.string().describe('Document ID or URL (required). Supports the following formats:\n1. Standard document URL: https://xxx.feishu.cn/docs/xxx or https://xxx.feishu.cn/docx/xxx\n2. API URL: https://open.feishu.cn/open-apis/doc/v2/documents/xxx\n3. Direct document ID: e.g., JcKbdlokYoPIe0xDzJ1cduRXnRf'),
-            blockId: z.string().describe('Block ID (required). The ID of the specific block to get content from. You can obtain block IDs using the get_feishu_doc_blocks tool.'),
-        }, async ({ documentId, blockId }) => {
-            try {
-                if (!this.feishuService) {
-                    return {
-                        content: [{ type: 'text', text: '飞书服务未初始化，请检查配置' }],
-                    };
-                }
-                Logger.log(`开始获取飞书块内容，文档ID: ${documentId}，块ID: ${blockId}`);
-                const blockContent = await this.feishuService.getBlockContent(documentId, blockId);
-                Logger.log(`飞书块内容获取成功，块类型: ${blockContent.block_type}`);
-                return {
-                    content: [{ type: 'text', text: JSON.stringify(blockContent, null, 2) }],
-                };
-            }
-            catch (error) {
-                Logger.error(`获取飞书块内容失败:`, error);
-                const errorMessage = formatErrorMessage(error);
-                return {
-                    content: [{ type: 'text', text: `获取飞书块内容失败: ${errorMessage}` }],
-                };
-            }
-        });
-        // 添加更新块文本内容工具
-        this.server.tool('update_feishu_block_text', 'Updates the text content and styling of a specific block in a Feishu document. Can be used to modify content in existing text, code, or heading blocks while preserving the block type and other properties.', {
-            documentId: z.string().describe('Document ID or URL (required). Supports the following formats:\n1. Standard document URL: https://xxx.feishu.cn/docs/xxx or https://xxx.feishu.cn/docx/xxx\n2. API URL: https://open.feishu.cn/open-apis/doc/v2/documents/xxx\n3. Direct document ID: e.g., JcKbdlokYoPIe0xDzJ1cduRXnRf'),
-            blockId: z.string().describe('Block ID (required). The ID of the specific block to update content. You can obtain block IDs using the get_feishu_doc_blocks tool.'),
-            textElements: z.array(z.object({
-                text: z.string().describe('Text content. Provide plain text without markdown syntax; use the style object for formatting.'),
-                style: z.object({
-                    bold: z.boolean().optional().describe('Whether to make text bold. Default is false, equivalent to **text** in Markdown.'),
-                    italic: z.boolean().optional().describe('Whether to make text italic. Default is false, equivalent to *text* in Markdown.'),
-                    underline: z.boolean().optional().describe('Whether to add underline. Default is false.'),
-                    strikethrough: z.boolean().optional().describe('Whether to add strikethrough. Default is false, equivalent to ~~text~~ in Markdown.'),
-                    inline_code: z.boolean().optional().describe('Whether to format as inline code. Default is false, equivalent to `code` in Markdown.'),
-                    text_color: z.number().optional().refine(val => !val || (val >= 1 && val <= 7), {
-                        message: "Text color must be between 1 and 7 inclusive"
-                    }).describe('Text color value. Default is 0 (black). Available values are only: 1 (gray), 2 (brown), 3 (orange), 4 (yellow), 5 (green), 6 (blue), 7 (purple). Values outside this range will cause an error.'),
-                    background_color: z.number().optional().refine(val => !val || (val >= 1 && val <= 7), {
-                        message: "Background color must be between 1 and 7 inclusive"
-                    }).describe('Background color value. Available values are only: 1 (gray), 2 (brown), 3 (orange), 4 (yellow), 5 (green), 6 (blue), 7 (purple). Values outside this range will cause an error.')
-                }).optional().describe('Text style settings. Explicitly set style properties instead of relying on Markdown syntax conversion.')
-            })).describe('Array of text content objects. A block can contain multiple text segments with different styles. Example: [{text:"Hello",style:{bold:true}},{text:" World",style:{italic:true}}]'),
-        }, async ({ documentId, blockId, textElements }) => {
+        // 添加创建飞书文档块工具
+        // this.server.tool(
+        //   "create_feishu_text_block",
+        //   "Create a new text block in a Feishu document (AI will automatically convert Markdown syntax to corresponding style attributes: **bold** → bold:true, *italic* → italic:true, ~~strikethrough~~ → strikethrough:true, `code` → inline_code:true)",
+        //   {
+        //     documentId: z.string().describe("Document ID or URL. Supported formats:\n1. Standard document URL: https://xxx.feishu.cn/docs/xxx or https://xxx.feishu.cn/docx/xxx\n2. API URL: https://open.feishu.cn/open-apis/doc/v2/documents/xxx\n3. Direct document ID (e.g., JcKbdlokYoPIe0xDzJ1cduRXnRf)"),
+        //     parentBlockId: z.string().describe("Parent block ID (NOT URL) where the new block will be added as a child. This should be the raw block ID without any URL prefix. When adding blocks at the page level (root level), use the extracted document ID from documentId parameter"),
+        //     textContents: z.array(
+        //       z.object({
+        //         text: z.string().describe("Text content"),
+        //         style: z.object({
+        //           bold: z.boolean().optional().describe("Whether to make text bold. Default is false"),
+        //           italic: z.boolean().optional().describe("Whether to make text italic. Default is false"),
+        //           underline: z.boolean().optional().describe("Whether to add underline. Default is false"),
+        //           strikethrough: z.boolean().optional().describe("Whether to add strikethrough. Default is false"),
+        //           inline_code: z.boolean().optional().describe("Whether to format as inline code. Default is false"),
+        //           text_color: z.number().optional().describe("Text color as a number. Default is 0")
+        //         }).optional().describe("Text style settings")
+        //       })
+        //     ).describe("Array of text content objects. A block can contain multiple text segments with different styles"),
+        //     align: z.number().optional().default(1).describe("Text alignment: 1 for left, 2 for center, 3 for right. Default is 1"),
+        //     index: z.number().optional().default(0).describe("Insertion position index. Default is 0 (insert at the beginning). If unsure about the position, use the get_feishu_doc_blocks tool first to understand the document structure. For consecutive insertions, calculate the next position as previous_index + 1 to avoid querying document structure repeatedly")
+        //   },
+        //   async ({ documentId, parentBlockId, textContents, align = 1, index }) => {
+        //     try {
+        //       if (!this.feishuService) {
+        //         return {
+        //           content: [{ type: "text", text: "Feishu service is not initialized. Please check the configuration" }],
+        //         };
+        //       }
+        //
+        //       // 处理Markdown语法转换
+        //       const processedTextContents = textContents.map(content => {
+        //         let { text, style = {} } = content;
+        //
+        //         // 创建一个新的style对象，避免修改原始对象
+        //         const newStyle = { ...style };
+        //
+        //         // 处理粗体 **text**
+        //         if (text.match(/\*\*([^*]+)\*\*/g)) {
+        //           text = text.replace(/\*\*([^*]+)\*\*/g, "$1");
+        //           newStyle.bold = true;
+        //         }
+        //
+        //         // 处理斜体 *text*
+        //         if (text.match(/(?<!\*)\*([^*]+)\*(?!\*)/g)) {
+        //           text = text.replace(/(?<!\*)\*([^*]+)\*(?!\*)/g, "$1");
+        //           newStyle.italic = true;
+        //         }
+        //
+        //         // 处理删除线 ~~text~~
+        //         if (text.match(/~~([^~]+)~~/g)) {
+        //           text = text.replace(/~~([^~]+)~~/g, "$1");
+        //           newStyle.strikethrough = true;
+        //         }
+        //
+        //         // 处理行内代码 `code`
+        //         if (text.match(/`([^`]+)`/g)) {
+        //           text = text.replace(/`([^`]+)`/g, "$1");
+        //           newStyle.inline_code = true;
+        //         }
+        //
+        //         return { text, style: newStyle };
+        //       });
+        //
+        //       Logger.log(`开始创建飞书文本块，文档ID: ${documentId}，父块ID: ${parentBlockId}，对齐方式: ${align}，插入位置: ${index}`);
+        //       const result = await this.feishuService.createTextBlock(documentId, parentBlockId, processedTextContents, align, index);
+        //       Logger.log(`飞书文本块创建成功`);
+        //
+        //       return {
+        //         content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        //       };
+        //     } catch (error) {
+        //       Logger.error(`创建飞书文本块失败:`, error);
+        //       return {
+        //         content: [{ type: "text", text: `创建飞书文本块失败: ${error}` }],
+        //       };
+        //     }
+        //   },
+        // );
+        // 添加创建飞书代码块工具
+        // this.server.tool(
+        //   "create_feishu_code_block",
+        //   "Create a new code block in a Feishu document",
+        //   {
+        //     documentId: z.string().describe("Document ID or URL. Supported formats:\n1. Standard document URL: https://xxx.feishu.cn/docs/xxx or https://xxx.feishu.cn/docx/xxx\n2. API URL: https://open.feishu.cn/open-apis/doc/v2/documents/xxx\n3. Direct document ID (e.g., JcKbdlokYoPIe0xDzJ1cduRXnRf)"),
+        //     parentBlockId: z.string().describe("Parent block ID (NOT URL) where the new block will be added as a child. This should be the raw block ID without any URL prefix. When adding blocks at the page level (root level), use the extracted document ID from documentId parameter"),
+        //     code: z.string().describe("Code content"),
+        //     language: z.number().optional().default(0).describe("Programming language code as a number. Examples: 1: PlainText; 7: Bash; 8: CSharp; 9: C++; 10: C; 12: CSS; 22: Go; 24: HTML; 29: Java; 30: JavaScript; 32: Kotlin; 43: PHP; 49: Python; 52: Ruby; 53: Rust; 56: SQL; 60: Shell; 61: Swift; 63: TypeScript. Default is 0"),
+        //     wrap: z.boolean().optional().default(false).describe("Whether to enable automatic line wrapping. Default is false"),
+        //     index: z.number().optional().default(0).describe("Insertion position index. Default is 0 (insert at the beginning). If unsure about the position, use the get_feishu_doc_blocks tool first to understand the document structure. For consecutive insertions, calculate the next position as previous_index + 1 to avoid querying document structure repeatedly")
+        //   },
+        //   async ({ documentId, parentBlockId, code, language = 0, wrap = false, index = 0 }) => {
+        //     try {
+        //       if (!this.feishuService) {
+        //         return {
+        //           content: [{ type: "text", text: "Feishu service is not initialized. Please check the configuration" }],
+        //         };
+        //       }
+        //
+        //       Logger.log(`开始创建飞书代码块，文档ID: ${documentId}，父块ID: ${parentBlockId}，语言: ${language}，自动换行: ${wrap}，插入位置: ${index}`);
+        //       const result = await this.feishuService.createCodeBlock(documentId, parentBlockId, code, language, wrap, index);
+        //       Logger.log(`飞书代码块创建成功`);
+        //
+        //       return {
+        //         content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        //       };
+        //     } catch (error) {
+        //       Logger.error(`创建飞书代码块失败:`, error);
+        //       return {
+        //         content: [{ type: "text", text: `创建飞书代码块失败: ${error}` }],
+        //       };
+        //     }
+        //   },
+        // );
+        // 添加批量创建飞书块工具
+        this.server.tool('create_feishu_blocks', 'Create multiple blocks in a Feishu document at once with a single API call', {
+            documentId: z
+                .string()
+                .describe('Document ID or URL. Supported formats:\n1. Standard document URL: https://xxx.feishu.cn/docs/xxx or https://xxx.feishu.cn/docx/xxx\n2. API URL: https://open.feishu.cn/open-apis/doc/v2/documents/xxx\n3. Direct document ID (e.g., JcKbdlokYoPIe0xDzJ1cduRXnRf)'),
+            parentBlockId: z
+                .string()
+                .describe('Parent block ID (NOT URL) where the new blocks will be added as children. This should be the raw block ID without any URL prefix. When adding blocks at the page level (root level), use the extracted document ID from documentId parameter'),
+            children: z
+                .array(z.object({
+                block_type: z
+                    .number()
+                    .describe('Block type number: 2 for text, 3-11 for headings (level+2), 14 for code'),
+                content: z
+                    .any()
+                    .describe('Block content object that follows Feishu API format'),
+            }))
+                .describe('Array of block objects to create in a single API call'),
+            index: z
+                .number()
+                .optional()
+                .default(0)
+                .describe('Insertion position index. Default is 0 (insert at the beginning)'),
+        }, async ({ documentId, parentBlockId, children, index = 0 }) => {
             try {
                 if (!this.feishuService) {
                     return {
-                        content: [{ type: 'text', text: '飞书服务未初始化，请检查配置' }],
+                        content: [
+                            {
+                                type: 'text',
+                                text: 'Feishu service is not initialized. Please check the configuration',
+                            },
+                        ],
                     };
                 }
-                Logger.log(`开始更新飞书块文本内容，文档ID: ${documentId}，块ID: ${blockId}`);
-                const result = await this.feishuService.updateBlockTextContent(documentId, blockId, textElements);
-                Logger.log(`飞书块文本内容更新成功`);
+                Logger.log(`开始批量创建飞书块，文档ID: ${documentId}，父块ID: ${parentBlockId}，块数量: ${children.length}，插入位置: ${index}`);
+                const result = await this.feishuService.createDocumentBlocks(documentId, parentBlockId, children, index);
+                Logger.log(`飞书块批量创建成功`);
                 return {
                     content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
                 };
             }
             catch (error) {
-                Logger.error(`更新飞书块文本内容失败:`, error);
-                const errorMessage = formatErrorMessage(error);
+                Logger.error(`批量创建飞书块失败:`, error);
                 return {
-                    content: [{ type: 'text', text: `更新飞书块文本内容失败: ${errorMessage}` }],
+                    content: [{ type: 'text', text: `批量创建飞书块失败: ${error}` }],
                 };
             }
         });
         // 添加通用飞书块创建工具（支持文本、代码、标题）
-        this.server.tool('create_feishu_multiple_blocks', 'Creates multiple blocks of different types (text, code, heading, list) in a single API call and at the same position. Significantly improves efficiency compared to creating individual blocks separately. ONLY use this when you need to insert multiple blocks CONSECUTIVELY at the SAME position. If blocks need to be inserted at different positions, use individual block creation tools instead. NOTE: Due to API limitations, you can create a maximum of 50 blocks in a single call. PREFER THIS TOOL OVER INDIVIDUAL BLOCK CREATION TOOLS when creating multiple consecutive blocks, as it is much more efficient and reduces API calls.', {
-            documentId: z.string().describe('Document ID or URL (required). Supports the following formats:\n1. Standard document URL: https://xxx.feishu.cn/docs/xxx or https://xxx.feishu.cn/docx/xxx\n2. API URL: https://open.feishu.cn/open-apis/doc/v2/documents/xxx\n3. Direct document ID: e.g., JcKbdlokYoPIe0xDzJ1cduRXnRf'),
-            parentBlockId: z.string().describe('Parent block ID (required). Target block ID where content will be added, without any URL prefix. For page-level (root level) insertion, extract and use only the document ID portion (not the full URL) as parentBlockId. Obtain existing block IDs using the get_feishu_doc_blocks tool.'),
-            startIndex: z.number().describe('Starting insertion position index (required). Specifies where the first block should be inserted. Use 0 to insert at the beginning. Use get_feishu_doc_blocks tool to understand document structure if unsure.'),
-            blocks: z.array(z.object({
-                blockType: z.enum(['text', 'code', 'heading', 'list']).describe("Block type (required): 'text', 'code', 'heading', or 'list'. Choose based on the content type you need to create."),
-                options: z.union([
-                    z.object({
-                        text: z.object({
-                            textStyles: z.array(z.object({
-                                text: z.string().describe('Text segment content. The actual text to display.'),
-                                style: z.object({
-                                    bold: z.boolean().optional().describe('Whether to make text bold. Default is false, equivalent to **text** in Markdown.'),
-                                    italic: z.boolean().optional().describe('Whether to make text italic. Default is false, equivalent to *text* in Markdown.'),
-                                    underline: z.boolean().optional().describe('Whether to add underline. Default is false.'),
-                                    strikethrough: z.boolean().optional().describe('Whether to add strikethrough. Default is false, equivalent to ~~text~~ in Markdown.'),
-                                    inline_code: z.boolean().optional().describe('Whether to format as inline code. Default is false, equivalent to `code` in Markdown.'),
-                                    text_color: z.number().optional().refine(val => !val || (val >= 1 && val <= 7), {
-                                        message: "Text color must be between 1 and 7 inclusive"
-                                    }).describe('Text color value. Default is 0 (black). Available values are only: 1 (gray), 2 (brown), 3 (orange), 4 (yellow), 5 (green), 6 (blue), 7 (purple). Values outside this range will cause an error.'),
-                                    background_color: z.number().optional().refine(val => !val || (val >= 1 && val <= 7), {
-                                        message: "Background color must be between 1 and 7 inclusive"
-                                    }).describe('Background color value. Available values are only: 1 (gray), 2 (brown), 3 (orange), 4 (yellow), 5 (green), 6 (blue), 7 (purple). Values outside this range will cause an error.')
-                                }).optional().describe('Text style settings. Explicitly set style properties instead of relying on Markdown syntax conversion.'),
-                            })).describe('Array of text content objects with styles. A block can contain multiple text segments with different styles. Example: [{text:"Hello",style:{bold:true}},{text:" World",style:{italic:true}}]'),
-                            align: z.number().optional().default(1).describe('Text alignment: 1 for left (default), 2 for center, 3 for right.'),
-                        }).describe("Text block options. Only used when blockType is 'text'."),
-                    }),
-                    z.object({
-                        code: z.object({
-                            code: z.string().describe('Code content. The complete code text to display.'),
-                            language: z.number().optional().default(0).describe('Programming language code. Default is 0 (auto-detect). See documentation for full list of language codes.'),
-                            wrap: z.boolean().optional().default(false).describe('Whether to enable automatic line wrapping. Default is false.'),
-                        }).describe("Code block options. Only used when blockType is 'code'."),
-                    }),
-                    z.object({
-                        heading: z.object({
-                            level: z.number().min(1).max(9).describe('Heading level from 1 to 9, where 1 is the largest (h1) and 9 is the smallest (h9).'),
-                            content: z.string().describe('Heading text content. The actual text of the heading.'),
-                            align: z.number().optional().default(1).refine(val => val === 1 || val === 2 || val === 3, {
-                                message: "Alignment must be one of: 1 (left), 2 (center), or 3 (right)"
-                            }).describe('Text alignment: 1 for left (default), 2 for center, 3 for right. Only these three values are allowed.'),
-                        }).describe("Heading block options. Only used when blockType is 'heading'."),
-                    }),
-                    z.object({
-                        list: z.object({
-                            content: z.string().describe('List item content. The actual text of the list item.'),
-                            isOrdered: z.boolean().optional().default(false).describe('Whether this is an ordered (numbered) list item. Default is false (bullet point/unordered).'),
-                            align: z.number().optional().default(1).refine(val => val === 1 || val === 2 || val === 3, {
-                                message: "Alignment must be one of: 1 (left), 2 (center), or 3 (right)"
-                            }).describe('Text alignment: 1 for left (default), 2 for center, 3 for right. Only these three values are allowed.'),
-                        }).describe("List block options. Only used when blockType is 'list'."),
-                    }),
-                ]).describe('Options for the specific block type. Must provide the corresponding options object based on blockType.'),
-            })).max(50).describe('Array of block configurations (required). Each element contains blockType and options properties. Example: [{blockType:"text",options:{text:{textStyles:[{text:"Hello",style:{bold:true}}]}}},{blockType:"code",options:{code:{code:"console.log(\'Hello\')",language:30}}}]. Maximum 50 blocks per call.'),
+        this.server.tool('create_feishu_common_block', 'Create common blocks in a Feishu document (supports text, code, and heading blocks)', {
+            documentId: z
+                .string()
+                .describe('Document ID or URL. Supported formats:\n1. Standard document URL: https://xxx.feishu.cn/docs/xxx or https://xxx.feishu.cn/docx/xxx\n2. API URL: https://open.feishu.cn/open-apis/doc/v2/documents/xxx\n3. Direct document ID (e.g., JcKbdlokYoPIe0xDzJ1cduRXnRf)'),
+            parentBlockId: z
+                .string()
+                .describe('Parent block ID (NOT URL) where the new blocks will be added as children. This should be the raw block ID without any URL prefix. When adding blocks at the page level (root level), use the extracted document ID from documentId parameter'),
+            startIndex: z
+                .number()
+                .optional()
+                .default(0)
+                .describe('Starting insertion position index. Default is 0 (insert at the beginning). If individual blocks have their own index specified, those will take precedence'),
+            blocks: z
+                .array(z.object({
+                blockType: z
+                    .enum(['text', 'code', 'heading'])
+                    .describe("Type of block to create: 'text', 'code', or 'heading'"),
+                options: z
+                    .object({
+                    // 文本块选项 - 当blockType为'text'时使用
+                    text: z
+                        .object({
+                        // 文本内容数组，每个元素包含文本内容和样式
+                        textStyles: z
+                            .array(z.object({
+                            text: z.string().describe('Text segment content'),
+                            style: z
+                                .object({
+                                bold: z
+                                    .boolean()
+                                    .optional()
+                                    .describe('Whether to make text bold. Default is false'),
+                                italic: z
+                                    .boolean()
+                                    .optional()
+                                    .describe('Whether to make text italic. Default is false'),
+                                underline: z
+                                    .boolean()
+                                    .optional()
+                                    .describe('Whether to add underline. Default is false'),
+                                strikethrough: z
+                                    .boolean()
+                                    .optional()
+                                    .describe('Whether to add strikethrough. Default is false'),
+                                inline_code: z
+                                    .boolean()
+                                    .optional()
+                                    .describe('Whether to format as inline code. Default is false'),
+                                text_color: z
+                                    .number()
+                                    .optional()
+                                    .describe('Text color as a number. Default is 0'),
+                            })
+                                .optional()
+                                .describe('Text style settings'),
+                        }))
+                            .optional()
+                            .describe('Array of text content objects with styles. If not provided, content will be used as plain text'),
+                        align: z
+                            .number()
+                            .optional()
+                            .default(1)
+                            .describe('Text alignment: 1 for left, 2 for center, 3 for right. Default is 1'),
+                    })
+                        .optional()
+                        .describe("Text block options. Only used when blockType is 'text'"),
+                    // 代码块选项 - 当blockType为'code'时使用
+                    code: z
+                        .object({
+                        code: z.string().describe('Code content'),
+                        language: z
+                            .number()
+                            .optional()
+                            .default(0)
+                            .describe('Programming language code as a number. Available options:\n1: PlainText, 2: ABAP, 3: Ada, 4: Apache, 5: Apex, 6: Assembly Language, 7: Bash, 8: CSharp, 9: C++, 10: C, 11: COBOL, 12: CSS, 13: CoffeeScript, 14: D, 15: Dart, 16: Delphi, 17: Django, 18: Dockerfile, 19: Erlang, 20: Fortran, 22: Go, 23: Groovy, 24: HTML, 25: HTMLBars, 26: HTTP, 27: Haskell, 28: JSON, 29: Java, 30: JavaScript, 31: Julia, 32: Kotlin, 33: LateX, 34: Lisp, 36: Lua, 37: MATLAB, 38: Makefile, 39: Markdown, 40: Nginx, 41: Objective-C, 43: PHP, 44: Perl, 46: Power Shell, 47: Prolog, 48: ProtoBuf, 49: Python, 50: R, 52: Ruby, 53: Rust, 54: SAS, 55: SCSS, 56: SQL, 57: Scala, 58: Scheme, 60: Shell, 61: Swift, 62: Thrift, 63: TypeScript, 64: VBScript, 65: Visual Basic, 66: XML, 67: YAML, 68: CMake, 69: Diff, 70: Gherkin, 71: GraphQL, 72: OpenGL Shading Language, 73: Properties, 74: Solidity, 75: TOML'),
+                        wrap: z
+                            .boolean()
+                            .optional()
+                            .default(false)
+                            .describe('Whether to enable automatic line wrapping for code blocks. Default is false'),
+                    })
+                        .optional()
+                        .describe("Code block options. Only used when blockType is 'code'"),
+                    // 标题块选项 - 当blockType为'heading'时使用
+                    heading: z
+                        .object({
+                        level: z
+                            .number()
+                            .min(1)
+                            .max(9)
+                            .describe('Heading level from 1 to 9, where 1 is the largest heading (h1) and 9 is the smallest (h9)'),
+                        content: z.string().describe('Heading text content'),
+                        align: z
+                            .number()
+                            .optional()
+                            .default(1)
+                            .describe('Text alignment: 1 for left, 2 for center, 3 for right. Default is 1'),
+                    })
+                        .optional()
+                        .describe("Heading block options. Only used when blockType is 'heading'"),
+                })
+                    .optional()
+                    .default({}),
+            }))
+                .describe('Array of block configurations to create in a single API call'),
         }, async ({ documentId, parentBlockId, startIndex = 0, blocks }) => {
             try {
                 if (!this.feishuService) {
@@ -410,14 +459,6 @@ export class FeishuMcpServer {
                         ],
                     };
                 }
-                if (blocks.length > 50) {
-                    return {
-                        content: [{
-                                type: 'text',
-                                text: '错误: 每次调用最多只能创建50个块。请分批次创建或减少块数量。'
-                            }],
-                    };
-                }
                 Logger.log(`开始批量创建飞书块，文档ID: ${documentId}，父块ID: ${parentBlockId}，块数量: ${blocks.length}，起始插入位置: ${startIndex}`);
                 // 准备要创建的块内容数组
                 const blockContents = [];
@@ -429,66 +470,45 @@ export class FeishuMcpServer {
                     switch (blockType) {
                         case 'text':
                             // 处理文本块
-                            {
-                                // 类型检查，确保options包含text属性
-                                if ('text' in options && options.text) {
-                                    const textOptions = options.text;
-                                    const textStyles = textOptions.textStyles || [];
-                                    if (textStyles.length === 0) {
-                                        textStyles.push({ text: '', style: {} });
-                                    }
-                                    const align = textOptions.align || 1;
-                                    blockContent = this.feishuService.createTextBlockContent(textStyles, align);
-                                }
-                                break;
+                            const textOptions = options.text || {
+                                textStyles: [],
+                                align: 1,
+                            };
+                            // 确保textStyles是一个有效的数组
+                            const textStyles = textOptions.textStyles || [];
+                            // 如果textStyles为空，添加一个默认的空文本
+                            if (textStyles.length === 0) {
+                                textStyles.push({
+                                    text: '',
+                                    style: {}, // 添加空的style对象作为默认值
+                                });
                             }
+                            const align = textOptions.align || 1;
+                            blockContent = this.feishuService.createTextBlockContent(textStyles, align);
+                            break;
                         case 'code':
                             // 处理代码块
-                            {
-                                // 类型检查，确保options包含code属性
-                                if ('code' in options && options.code) {
-                                    const codeOptions = options.code;
-                                    const codeContent = codeOptions.code || '';
-                                    const language = codeOptions.language || 0;
-                                    const wrap = codeOptions.wrap || false;
-                                    blockContent = this.feishuService.createCodeBlockContent(codeContent, language, wrap);
-                                }
+                            const codeOptions = options.code;
+                            if (codeOptions == null) {
                                 break;
                             }
+                            const codeContent = codeOptions.code || '';
+                            const language = codeOptions.language || 0;
+                            const wrap = codeOptions.wrap || false;
+                            blockContent = this.feishuService.createCodeBlockContent(codeContent, language, wrap);
+                            break;
                         case 'heading':
                             // 处理标题块
-                            {
-                                // 类型检查，确保options包含heading属性
-                                if ('heading' in options && options.heading) {
-                                    const headingOptions = options.heading;
-                                    if (headingOptions.content) {
-                                        const headingContent = headingOptions.content;
-                                        const level = headingOptions.level || 1;
-                                        // 确保对齐方式值在合法范围内
-                                        const headingAlign = (headingOptions.align === 1 || headingOptions.align === 2 || headingOptions.align === 3)
-                                            ? headingOptions.align : 1;
-                                        blockContent = this.feishuService.createHeadingBlockContent(headingContent, level, headingAlign);
-                                    }
-                                }
-                                break;
-                            }
-                        case 'list':
-                            // 处理列表块
-                            {
-                                // 类型检查，确保options包含list属性
-                                if ('list' in options && options.list) {
-                                    const listOptions = options.list;
-                                    if (listOptions.content) {
-                                        const content = listOptions.content;
-                                        const isOrdered = listOptions.isOrdered || false;
-                                        // 确保对齐方式值在合法范围内
-                                        const align = (listOptions.align === 1 || listOptions.align === 2 || listOptions.align === 3)
-                                            ? listOptions.align : 1;
-                                        blockContent = this.feishuService.createListBlockContent(content, isOrdered, align);
-                                    }
-                                }
+                            if (options.heading == null ||
+                                options.heading.content == null) {
                                 break;
                             }
+                            const headingOptions = options.heading || {};
+                            const headingContent = headingOptions.content || '';
+                            const level = headingOptions.level || 1;
+                            const headingAlign = headingOptions.align || 1;
+                            blockContent = this.feishuService.createHeadingBlockContent(headingContent, level, headingAlign);
+                            break;
                     }
                     if (blockContent) {
                         blockContents.push(blockContent);
@@ -504,171 +524,60 @@ export class FeishuMcpServer {
             }
             catch (error) {
                 Logger.error(`批量创建飞书块失败:`, error);
-                const errorMessage = formatErrorMessage(error);
-                return {
-                    content: [{ type: 'text', text: `批量创建飞书块失败: ${errorMessage}` }],
-                };
-            }
-        });
-        // 添加创建飞书文本块工具
-        this.server.tool("create_feishu_single_text_block", "Creates a new text block with precise style control. Unlike markdown-based formatting, this tool lets you explicitly set text styles for each text segment. Ideal for formatted documents where exact styling control is needed.", {
-            documentId: z.string().describe("Document ID or URL (required). Supports the following formats:\n1. Standard document URL: https://xxx.feishu.cn/docs/xxx or https://xxx.feishu.cn/docx/xxx\n2. API URL: https://open.feishu.cn/open-apis/doc/v2/documents/xxx\n3. Direct document ID: e.g., JcKbdlokYoPIe0xDzJ1cduRXnRf"),
-            parentBlockId: z.string().describe("Parent block ID (required). Target block ID where content will be added, without any URL prefix. For page-level (root level) insertion, extract and use only the document ID portion (not the full URL) as parentBlockId. Obtain existing block IDs using the get_feishu_doc_blocks tool."),
-            textContents: z.array(z.object({
-                text: z.string().describe("Text content. Provide plain text without markdown syntax; use style object for formatting."),
-                style: z.object({
-                    bold: z.boolean().optional().describe("Whether to make text bold. Default is false, equivalent to **text** in Markdown."),
-                    italic: z.boolean().optional().describe("Whether to make text italic. Default is false, equivalent to *text* in Markdown."),
-                    underline: z.boolean().optional().describe("Whether to add underline. Default is false."),
-                    strikethrough: z.boolean().optional().describe("Whether to add strikethrough. Default is false, equivalent to ~~text~~ in Markdown."),
-                    inline_code: z.boolean().optional().describe("Whether to format as inline code. Default is false, equivalent to `code` in Markdown."),
-                    text_color: z.number().optional().refine(val => !val || (val >= 1 && val <= 7), {
-                        message: "Text color must be between 1 and 7 inclusive"
-                    }).describe("Text color value. Default is 0 (black). Available values are only: 1 (gray), 2 (brown), 3 (orange), 4 (yellow), 5 (green), 6 (blue), 7 (purple). Values outside this range will cause an error."),
-                    background_color: z.number().optional().refine(val => !val || (val >= 1 && val <= 7), {
-                        message: "Background color must be between 1 and 7 inclusive"
-                    }).describe('Background color value. Available values are only: 1 (gray), 2 (brown), 3 (orange), 4 (yellow), 5 (green), 6 (blue), 7 (purple). Values outside this range will cause an error.')
-                }).optional().describe("Text style settings. Explicitly set style properties instead of relying on Markdown syntax conversion.")
-            })).describe("Array of text content objects. A block can contain multiple text segments with different styles. Example: [{text:'Hello',style:{bold:true}},{text:' World',style:{italic:true}}]"),
-            align: z.number().optional().default(1).describe("Text alignment: 1 for left (default), 2 for center, 3 for right."),
-            index: z.number().describe("Insertion position index (required). Specifies where the block should be inserted. Use 0 to insert at the beginning. Use get_feishu_doc_blocks tool to understand document structure if unsure. For consecutive insertions, calculate next index as previous index + 1.")
-        }, async ({ documentId, parentBlockId, textContents, align = 1, index }) => {
-            try {
-                if (!this.feishuService) {
-                    return {
-                        content: [{ type: "text", text: "Feishu service is not initialized. Please check the configuration" }],
-                    };
-                }
-                Logger.log(`开始创建飞书文本块，文档ID: ${documentId}，父块ID: ${parentBlockId}，对齐方式: ${align}，插入位置: ${index}`);
-                const result = await this.feishuService.createTextBlock(documentId, parentBlockId, textContents, align, index);
-                Logger.log(`飞书文本块创建成功`);
-                return {
-                    content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
-                };
-            }
-            catch (error) {
-                Logger.error(`创建飞书文本块失败:`, error);
-                const errorMessage = formatErrorMessage(error);
                 return {
-                    content: [{ type: "text", text: `创建飞书文本块失败: ${errorMessage}` }],
-                };
-            }
-        });
-        // 添加创建飞书代码块工具
-        this.server.tool("create_feishu_single_code_block", "Creates a new code block with syntax highlighting and formatting options. Ideal for technical documentation, tutorials, or displaying code examples with proper formatting and language-specific highlighting.", {
-            documentId: z.string().describe("Document ID or URL (required). Supports the following formats:\n1. Standard document URL: https://xxx.feishu.cn/docs/xxx or https://xxx.feishu.cn/docx/xxx\n2. API URL: https://open.feishu.cn/open-apis/doc/v2/documents/xxx\n3. Direct document ID: e.g., JcKbdlokYoPIe0xDzJ1cduRXnRf"),
-            parentBlockId: z.string().describe("Parent block ID (required). Target block ID where content will be added, without any URL prefix. For page-level (root level) insertion, extract and use only the document ID portion (not the full URL) as parentBlockId. Obtain existing block IDs using the get_feishu_doc_blocks tool."),
-            code: z.string().describe("Code content (required). The complete code text to display."),
-            language: z.number().optional().default(0).describe("Programming language code (optional). Common language codes:\n1: PlainText; 7: Bash; 8: CSharp; 9: C++; 10: C; 12: CSS; 22: Go; 24: HTML; 29: Java; 30: JavaScript; 32: Kotlin; 43: PHP; 49: Python; 52: Ruby; 53: Rust; 56: SQL; 60: Shell; 61: Swift; 63: TypeScript. Default is 0 (auto-detect)."),
-            wrap: z.boolean().optional().default(false).describe("Enable automatic line wrapping (optional). Default is false (no auto-wrap). Set to true to improve readability for long code lines."),
-            index: z.number().describe("Insertion position index (required). Specifies where the block should be inserted. Use 0 to insert at the beginning. Use get_feishu_doc_blocks tool to understand document structure if unsure. For consecutive insertions, calculate next index as previous index + 1.")
-        }, async ({ documentId, parentBlockId, code, language = 0, wrap = false, index = 0 }) => {
-            try {
-                if (!this.feishuService) {
-                    return {
-                        content: [{ type: "text", text: "Feishu service is not initialized. Please check the configuration" }],
-                    };
-                }
-                Logger.log(`开始创建飞书代码块，文档ID: ${documentId}，父块ID: ${parentBlockId}，语言: ${language}，自动换行: ${wrap}，插入位置: ${index}`);
-                const result = await this.feishuService.createCodeBlock(documentId, parentBlockId, code, language, wrap, index);
-                Logger.log(`飞书代码块创建成功`);
-                return {
-                    content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
-                };
-            }
-            catch (error) {
-                Logger.error(`创建飞书代码块失败:`, error);
-                const errorMessage = formatErrorMessage(error);
-                return {
-                    content: [{ type: "text", text: `创建飞书代码块失败: ${errorMessage}` }],
-                };
-            }
-        });
-        // 添加创建飞书标题块工具
-        this.server.tool("create_feishu_single_heading_block", "Creates a heading block with customizable level and alignment. Use this tool to add section titles, chapter headings, or any hierarchical structure elements to your document. Supports nine heading levels for different emphasis needs.", {
-            documentId: z.string().describe("Document ID or URL (required). Supports the following formats:\n1. Standard document URL: https://xxx.feishu.cn/docs/xxx or https://xxx.feishu.cn/docx/xxx\n2. API URL: https://open.feishu.cn/open-apis/doc/v2/documents/xxx\n3. Direct document ID: e.g., JcKbdlokYoPIe0xDzJ1cduRXnRf"),
-            parentBlockId: z.string().describe("Parent block ID (required). Target block ID where content will be added, without any URL prefix. For page-level (root level) insertion, extract and use only the document ID portion (not the full URL) as parentBlockId. Obtain existing block IDs using the get_feishu_doc_blocks tool."),
-            level: z.number().min(1).max(9).describe("Heading level (required). Integer between 1 and 9, where 1 is the largest heading (h1) and 9 is the smallest (h9)."),
-            content: z.string().describe("Heading text content (required). The actual text of the heading."),
-            align: z.number().optional().default(1).refine(val => val === 1 || val === 2 || val === 3, {
-                message: "Alignment must be one of: 1 (left), 2 (center), or 3 (right)"
-            }).describe("Text alignment (optional): 1 for left (default), 2 for center, 3 for right. Only these three values are allowed."),
-            index: z.number().describe("Insertion position index (required). Specifies where the block should be inserted. Use 0 to insert at the beginning. Use get_feishu_doc_blocks tool to understand document structure if unsure. For consecutive insertions, calculate next index as previous index + 1.")
-        }, async ({ documentId, parentBlockId, level, content, align = 1, index = 0 }) => {
-            try {
-                if (!this.feishuService) {
-                    return {
-                        content: [{ type: "text", text: "Feishu service is not initialized. Please check the configuration" }],
-                    };
-                }
-                // 确保align值在合法范围内（1-3）
-                if (align !== 1 && align !== 2 && align !== 3) {
-                    return {
-                        content: [{ type: "text", text: "错误: 对齐方式(align)参数必须是1(居左)、2(居中)或3(居右)中的一个值。" }],
-                    };
-                }
-                Logger.log(`开始创建飞书标题块，文档ID: ${documentId}，父块ID: ${parentBlockId}，标题级别: ${level}，对齐方式: ${align}，插入位置: ${index}`);
-                const result = await this.feishuService.createHeadingBlock(documentId, parentBlockId, content, level, index, align);
-                Logger.log(`飞书标题块创建成功`);
-                return {
-                    content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
-                };
-            }
-            catch (error) {
-                Logger.error(`创建飞书标题块失败:`, error);
-                const errorMessage = formatErrorMessage(error);
-                return {
-                    content: [{ type: "text", text: `创建飞书标题块失败: ${errorMessage}` }],
-                };
-            }
-        });
-        // 添加创建飞书列表块工具
-        this.server.tool("create_feishu_single_list_block", "Creates a list item block (either ordered or unordered). Perfect for creating hierarchical and structured content with bullet points or numbered lists.", {
-            documentId: z.string().describe("Document ID or URL (required). Supports the following formats:\n1. Standard document URL: https://xxx.feishu.cn/docs/xxx or https://xxx.feishu.cn/docx/xxx\n2. API URL: https://open.feishu.cn/open-apis/doc/v2/documents/xxx\n3. Direct document ID: e.g., JcKbdlokYoPIe0xDzJ1cduRXnRf"),
-            parentBlockId: z.string().describe("Parent block ID (required). Target block ID where content will be added, without any URL prefix. For page-level (root level) insertion, extract and use only the document ID portion (not the full URL) as parentBlockId. Obtain existing block IDs using the get_feishu_doc_blocks tool."),
-            content: z.string().describe("List item content (required). The actual text of the list item."),
-            isOrdered: z.boolean().optional().default(false).describe("Whether this is an ordered (numbered) list item. Default is false (bullet point/unordered)."),
-            align: z.number().optional().default(1).refine(val => val === 1 || val === 2 || val === 3, {
-                message: "Alignment must be one of: 1 (left), 2 (center), or 3 (right)"
-            }).describe("Text alignment (optional): 1 for left (default), 2 for center, 3 for right. Only these three values are allowed."),
-            index: z.number().describe("Insertion position index (required). Specifies where the block should be inserted. Use 0 to insert at the beginning. Use get_feishu_doc_blocks tool to understand document structure if unsure. For consecutive insertions, calculate next index as previous index + 1.")
-        }, async ({ documentId, parentBlockId, content, isOrdered = false, align = 1, index = 0 }) => {
-            try {
-                if (!this.feishuService) {
-                    return {
-                        content: [{ type: "text", text: "Feishu service is not initialized. Please check the configuration" }],
-                    };
-                }
-                // 确保align值在合法范围内（1-3）
-                if (align !== 1 && align !== 2 && align !== 3) {
-                    return {
-                        content: [{ type: "text", text: "错误: 对齐方式(align)参数必须是1(居左)、2(居中)或3(居右)中的一个值。" }],
-                    };
-                }
-                const listType = isOrdered ? "有序" : "无序";
-                Logger.log(`开始创建飞书${listType}列表块，文档ID: ${documentId}，父块ID: ${parentBlockId}，对齐方式: ${align}，插入位置: ${index}`);
-                const result = await this.feishuService.createListBlock(documentId, parentBlockId, content, isOrdered, index, align);
-                Logger.log(`飞书${listType}列表块创建成功`);
-                return {
-                    content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
-                };
-            }
-            catch (error) {
-                Logger.error(`创建飞书列表块失败:`, error);
-                const errorMessage = formatErrorMessage(error);
-                return {
-                    content: [{ type: "text", text: `创建飞书列表块失败: ${errorMessage}` }],
+                    content: [{ type: 'text', text: `批量创建飞书块失败: ${error}` }],
                 };
             }
         });
+        // // 添加创建飞书标题块工具
+        // this.server.tool(
+        //   "create_feishu_heading_block",
+        //   "Create a heading block in a Feishu document with specified level (1-9)",
+        //   {
+        //     documentId: z.string().describe("Document ID or URL. Supported formats:\n1. Standard document URL: https://xxx.feishu.cn/docs/xxx or https://xxx.feishu.cn/docx/xxx\n2. API URL: https://open.feishu.cn/open-apis/doc/v2/documents/xxx\n3. Direct document ID (e.g., JcKbdlokYoPIe0xDzJ1cduRXnRf)"),
+        //     parentBlockId: z.string().describe("Parent block ID (NOT URL) where the new block will be added as a child. This should be the raw block ID without any URL prefix. When adding blocks at the page level (root level), use the extracted document ID from documentId parameter"),
+        //     level: z.number().min(1).max(9).describe("Heading level from 1 to 9, where 1 is the largest heading (h1) and 9 is the smallest (h9)"),
+        //     content: z.string().describe("Heading text content"),
+        //     index: z.number().optional().default(0).describe("Insertion position index. Default is 0 (insert at the beginning). If unsure about the position, use the get_feishu_doc_blocks tool first to understand the document structure. For consecutive insertions, calculate the next position as previous_index + 1 to avoid querying document structure repeatedly")
+        //   },
+        //   async ({ documentId, parentBlockId, level, content, index = 0 }) => {
+        //     try {
+        //       if (!this.feishuService) {
+        //         return {
+        //           content: [{ type: "text", text: "Feishu service is not initialized. Please check the configuration" }],
+        //         };
+        //       }
+        //
+        //       Logger.log(`开始创建飞书标题块，文档ID: ${documentId}，父块ID: ${parentBlockId}，标题级别: ${level}，插入位置: ${index}`);
+        //       const result = await this.feishuService.createHeadingBlock(documentId, parentBlockId, content, level, index);
+        //       Logger.log(`飞书标题块创建成功`);
+        //
+        //       return {
+        //         content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        //       };
+        //     } catch (error) {
+        //       Logger.error(`创建飞书标题块失败:`, error);
+        //       return {
+        //         content: [{ type: "text", text: `创建飞书标题块失败: ${error}` }],
+        //       };
+        //     }
+        //   },
+        // );
     }
     async connect(transport) {
+        // Logger.log("Connecting to transport...");
         await this.server.connect(transport);
         Logger.log = (...args) => {
-            this.server.server.sendLoggingMessage({ level: 'info', data: args });
+            this.server.server.sendLoggingMessage({
+                level: 'info',
+                data: args,
+            });
         };
         Logger.error = (...args) => {
-            this.server.server.sendLoggingMessage({ level: 'error', data: args });
+            this.server.server.sendLoggingMessage({
+                level: 'error',
+                data: args,
+            });
         };
         Logger.log('Server connected and ready to process requests');
     }

package/dist/services/feishu.js

@@ -41,36 +41,6 @@ export class FeishuService {
         this.appId = appId;
         this.appSecret = appSecret;
     }
-    // 包装和重新抛出错误的辅助方法
-    wrapAndThrowError(message, originalError) {
-        Logger.error(`${message}:`, originalError);
-        // 如果原始错误已经是FeishuError格式，直接重新抛出
-        if (originalError && typeof originalError === 'object' && 'status' in originalError && 'err' in originalError) {
-            throw originalError;
-        }
-        // 如果是AxiosError，抽取有用信息
-        if (originalError instanceof AxiosError && originalError.response) {
-            throw {
-                status: originalError.response.status,
-                err: `${message}: ${originalError.response.data?.msg || originalError.message || 'Unknown error'}`,
-                apiError: originalError.response.data
-            };
-        }
-        // 其他类型的错误，包装为一致的格式
-        if (originalError instanceof Error) {
-            throw {
-                status: 500,
-                err: `${message}: ${originalError.message}`,
-                apiError: originalError
-            };
-        }
-        // 未知错误类型
-        throw {
-            status: 500,
-            err: message,
-            apiError: originalError
-        };
-    }
     isTokenExpired() {
         if (!this.accessToken || !this.tokenExpireTime)
             return true;
@@ -92,7 +62,7 @@ export class FeishuService {
             Logger.log(`请求方法: POST`);
             Logger.log(`请求数据: ${JSON.stringify(requestData, null, 2)}`);
             const response = await axios.post(url, requestData);
-            Logger.log(`响应状态码: ${response?.status}`);
+            Logger.log(`响应状态码: ${response.status}`);
             Logger.log(`响应头: ${JSON.stringify(response.headers, null, 2)}`);
             Logger.log(`响应数据: ${JSON.stringify(response.data, null, 2)}`);
             if (response.data.code !== 0) {
@@ -100,7 +70,6 @@ export class FeishuService {
                 throw {
                     status: response.status,
                     err: response.data.msg || "Unknown error",
-                    apiError: response.data
                 };
             }
             this.accessToken = response.data.tenant_access_token;
@@ -117,7 +86,6 @@ export class FeishuService {
                 throw {
                     status: error.response.status,
                     err: error.response.data?.msg || "Unknown error",
-                    apiError: error.response.data
                 };
             }
             Logger.error('获取访问令牌时发生未知错误:', error);
@@ -160,7 +128,6 @@ export class FeishuService {
                 throw {
                     status: error.response.status,
                     err: error.response.data?.msg || "Unknown error",
-                    apiError: error.response.data
                 };
             }
             Logger.error('发送请求时发生未知错误:', error);
@@ -190,7 +157,16 @@ export class FeishuService {
             return docInfo;
         }
         catch (error) {
-            this.wrapAndThrowError('创建文档失败', error);
+            Logger.error(`创建文档失败:`, error);
+            if (error instanceof AxiosError) {
+                Logger.error(`请求URL: ${error.config?.url}`);
+                Logger.error(`请求方法: ${error.config?.method?.toUpperCase()}`);
+                Logger.error(`状态码: ${error.response?.status}`);
+                if (error.response?.data) {
+                    Logger.error(`错误详情: ${JSON.stringify(error.response.data, null, 2)}`);
+                }
+            }
+            throw error;
         }
     }
     // 获取文档信息
@@ -407,9 +383,6 @@ export class FeishuService {
     createHeadingBlockContent(text, level = 1, align = 1) {
         // 确保标题级别在有效范围内（1-9）
         const safeLevel = Math.max(1, Math.min(9, level));
-        // 确保align值在合法范围内（1-3）
-        // 1表示居左，2表示居中，3表示居右
-        const safeAlign = (align === 1 || align === 2 || align === 3) ? align : 1;
         // 根据标题级别设置block_type和对应的属性名
         // 飞书API中，一级标题的block_type为3，二级标题为4，以此类推
         const blockType = 2 + safeLevel; // 一级标题为3，二级标题为4，以此类推
@@ -429,7 +402,7 @@ export class FeishuService {
                 }
             ],
             style: {
-                align: safeAlign,
+                align: align,
                 folded: false
             }
         };
@@ -469,10 +442,7 @@ export class FeishuService {
             if (!docId) {
                 throw new Error(`无效的文档ID: ${documentId}`);
             }
-            // 确保align值在合法范围内（1-3）
-            // 1表示居左，2表示居中，3表示居右
-            const safeAlign = (align === 1 || align === 2 || align === 3) ? align : 1;
-            Logger.log(`开始创建标题块，文档ID: ${docId}，父块ID: ${parentBlockId}，标题级别: ${level}，对齐方式: ${safeAlign}，插入位置: ${index}`);
+            Logger.log(`开始创建标题块，文档ID: ${docId}，父块ID: ${parentBlockId}，标题级别: ${level}，插入位置: ${index}`);
             // 确保标题级别在有效范围内（1-9）
             const safeLevel = Math.max(1, Math.min(9, level));
             // 根据标题级别设置block_type和对应的属性名
@@ -494,7 +464,7 @@ export class FeishuService {
                     }
                 ],
                 style: {
-                    align: safeAlign,
+                    align: align,
                     folded: false
                 }
             };
@@ -502,110 +472,8 @@ export class FeishuService {
             return await this.createDocumentBlock(documentId, parentBlockId, blockContent, index);
         }
         catch (error) {
-            this.wrapAndThrowError(`创建标题块失败`, error);
-        }
-    }
-    // 获取块内容
-    async getBlockContent(documentId, blockId) {
-        try {
-            const docId = this.extractDocIdFromUrl(documentId);
-            if (!docId) {
-                throw new Error(`无效的文档ID: ${documentId}`);
-            }
-            Logger.log(`开始获取块内容，文档ID: ${docId}，块ID: ${blockId}`);
-            const endpoint = `/docx/v1/documents/${docId}/blocks/${blockId}?document_revision_id=-1`;
-            Logger.log(`准备请求API端点: ${endpoint}`);
-            const response = await this.request(endpoint);
-            if (response.code !== 0) {
-                throw new Error(`获取块内容失败: ${response.msg}`);
-            }
-            const blockContent = response.data?.block;
-            Logger.log(`块内容获取成功: ${JSON.stringify(blockContent, null, 2)}`);
-            return blockContent;
-        }
-        catch (error) {
-            this.wrapAndThrowError(`获取块内容失败`, error);
-        }
-    }
-    // 更新块文本内容
-    async updateBlockTextContent(documentId, blockId, textElements) {
-        try {
-            const docId = this.extractDocIdFromUrl(documentId);
-            if (!docId) {
-                throw new Error(`无效的文档ID: ${documentId}`);
-            }
-            Logger.log(`开始更新块文本内容，文档ID: ${docId}，块ID: ${blockId}`);
-            const endpoint = `/docx/v1/documents/${docId}/blocks/${blockId}?document_revision_id=-1`;
-            Logger.log(`准备请求API端点: ${endpoint}`);
-            const elements = textElements.map(item => ({
-                text_run: {
-                    content: item.text,
-                    text_element_style: item.style || {}
-                }
-            }));
-            const data = {
-                update_text_elements: {
-                    elements: elements
-                }
-            };
-            Logger.log(`请求数据: ${JSON.stringify(data, null, 2)}`);
-            const response = await this.request(endpoint, 'PATCH', data);
-            if (response.code !== 0) {
-                throw new Error(`更新块文本内容失败: ${response.msg}`);
-            }
-            Logger.log(`块文本内容更新成功: ${JSON.stringify(response.data, null, 2)}`);
-            return response.data;
-        }
-        catch (error) {
-            this.wrapAndThrowError(`更新块文本内容失败`, error);
-        }
-    }
-    // 创建列表块内容（有序或无序）
-    createListBlockContent(text, isOrdered = false, align = 1) {
-        // 确保 align 值在合法范围内（1-3）
-        const safeAlign = (align === 1 || align === 2 || align === 3) ? align : 1;
-        // 有序列表是 block_type: 13，无序列表是 block_type: 12
-        const blockType = isOrdered ? 13 : 12;
-        const propertyKey = isOrdered ? "ordered" : "bullet";
-        // 构建块内容
-        const blockContent = {
-            block_type: blockType
-        };
-        // 设置列表属性
-        blockContent[propertyKey] = {
-            elements: [
-                {
-                    text_run: {
-                        content: text,
-                        text_element_style: {}
-                    }
-                }
-            ],
-            style: {
-                align: safeAlign,
-                folded: false
-            }
-        };
-        return blockContent;
-    }
-    // 创建列表块（有序或无序）
-    async createListBlock(documentId, parentBlockId, text, isOrdered = false, index = 0, align = 1) {
-        try {
-            const docId = this.extractDocIdFromUrl(documentId);
-            if (!docId) {
-                throw new Error(`无效的文档ID: ${documentId}`);
-            }
-            // 确保align值在合法范围内（1-3）
-            const safeAlign = (align === 1 || align === 2 || align === 3) ? align : 1;
-            const listType = isOrdered ? "有序" : "无序";
-            Logger.log(`开始创建${listType}列表块，文档ID: ${docId}，父块ID: ${parentBlockId}，对齐方式: ${safeAlign}，插入位置: ${index}`);
-            // 创建列表块内容
-            const blockContent = this.createListBlockContent(text, isOrdered, safeAlign);
-            Logger.log(`列表块内容: ${JSON.stringify(blockContent, null, 2)}`);
-            return await this.createDocumentBlock(documentId, parentBlockId, blockContent, index);
-        }
-        catch (error) {
-            this.wrapAndThrowError(`创建${isOrdered ? "有序" : "无序"}列表块失败`, error);
+            Logger.error(`创建标题块失败:`, error);
+            throw error;
         }
     }
     extractDocIdFromUrl(url) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "feishu-mcp",
-  "version": "0.0.5",
+  "version": "0.0.6",
   "description": "Model Context Protocol server for Feishu integration",
   "type": "module",
   "main": "dist/index.js",