feishu-mcp 0.1.1 → 0.1.2

package/README.md

@@ -24,6 +24,10 @@
   <img src="image/demo.png" alt="飞书 MCP 使用演示" width="800"/>
 </a>
 
+<a href="https://www.bilibili.com/video/BV18z3gzdE1w/?vd_source=94c14da5a71aeb01f665f159dd3d89c8">
+  <img src="image/demo_1.png" alt="飞书 MCP 使用演示" width="800"/>
+</a>
+
 > ⭐ **Star 本项目，第一时间获取最新功能和重要更新！** 关注项目可以让你不错过任何新特性、修复和优化，助你持续高效使用。你的支持也将帮助我们更好地完善和发展项目。⭐
 
 ---
@@ -44,13 +48,12 @@
 | **工具功能** | `convert_feishu_wiki_to_document_id`                         | Wiki链接转换          | 将Wiki链接转为文档ID | ✅ 已完成 |
 | | `get_feishu_image_resource`                                  | 获取图片资源            | 下载文档中的图片      | ✅ 已完成 |
 | | `get_feishu_whiteboard_content`                              | 获取画板内容 | 获取画板中的图形元素和结构(流程图、思维导图等) | ✅ 已完成 |
-| **高级功能** | 表格操作                                                         | 创建和编辑表格           | 结构化数据展示       | 🚧 计划中 |
-| | 图表插入                                                         | 支持各类数据可视化图表       | 数据展示和分析       | 🚧 计划中 |
+| **高级功能** | `create_feishu_table`                                         | 创建和编辑表格           | 结构化数据展示       | ✅ 已完成 |
 | | 流程图插入                                                        | 支持流程图和思维导图        | 流程梳理和可视化      | ✅ 已完成 |
 | 图片插入  | `upload_and_bind_image_to_block` | 支持插入本地和远程图片       | 修改文档内容        | ✅ 已完成 |
 | | 公式支持                                                         | 支持数学公式            | 学术和技术文档       | ✅ 已完成 |
 
-### 🎨 支持的样式功能
+### 🎨 支持的样式功能（基本支持md所有格式）
 
 - **文本样式**：粗体、斜体、下划线、删除线、行内代码
 - **文本颜色**：灰色、棕色、橙色、黄色、绿色、蓝色、紫色
@@ -61,6 +64,7 @@
 - **图片**：支持本地图片和网络图片
 - **公式**：在文本块中插入数学公式，支持LaTeX语法
 - **mermaid图表**：支持流程图、时序图、思维导图、类图、饼图等等
+- **表格**：支持创建多行列表格，单元格可包含文本、标题、列表、代码块等多种内容类型
 
 ---
 
@@ -73,6 +77,7 @@
 - ~~**支持多种凭证类型**：包括 tenant_access_token和 user_access_token，满足不同场景下的认证需求~~  (飞书应用配置发生变更) 0.0.16 ✅。
 - **支持cursor用户登录**：方便在cursor平台用户认证
 - ~~**支持mermaid图表**：流程图、时序图等等，丰富文档内容~~ 0.1.11 ✅
+- ~~**支持表格创建**：创建包含各种块类型的复杂表格，支持样式控制~~ 0.1.2 ✅
 
 ---
 

package/dist/mcp/feishuMcp.js

@@ -6,7 +6,7 @@ import { registerFeishuBlockTools } from './tools/feishuBlockTools.js';
 import { registerFeishuFolderTools } from './tools/feishuFolderTools.js';
 const serverInfo = {
     name: "Feishu MCP Server",
-    version: "0.1.0",
+    version: "0.1.2",
 };
 const serverOptions = {
     capabilities: { logging: {}, tools: {} },

package/dist/mcp/tools/feishuBlockTools.js

@@ -8,11 +8,11 @@ import { DocumentIdSchema, ParentBlockIdSchema, BlockIdSchema, IndexSchema, Star
 TextElementsArraySchema, 
 // CodeLanguageSchema,
 // CodeWrapSchema,
-BlockConfigSchema, MediaIdSchema, MediaExtraSchema, ImagesArraySchema,
+BlockConfigSchema, MediaIdSchema, MediaExtraSchema, ImagesArraySchema, 
 // MermaidCodeSchema,
 // ImageWidthSchema,
 // ImageHeightSchema
- } from '../../types/feishuSchema.js';
+TableCreateSchema } from '../../types/feishuSchema.js';
 /**
  * 注册飞书块相关的MCP工具
  * @param server MCP服务器实例
@@ -618,4 +618,45 @@ export function registerFeishuBlockTools(server, feishuService) {
             };
         }
     });
+    // 添加创建飞书表格工具
+    server.tool('create_feishu_table', 'Creates a table block in a Feishu document with specified rows and columns. Each cell can contain different types of content blocks (text, lists, code, etc.). This tool creates the complete table structure including table cells and their content. Note: For Feishu wiki links (https://xxx.feishu.cn/wiki/xxx) you must first use convert_feishu_wiki_to_document_id tool to obtain a compatible document ID.', {
+        documentId: DocumentIdSchema,
+        parentBlockId: ParentBlockIdSchema,
+        index: IndexSchema,
+        tableConfig: TableCreateSchema,
+    }, async ({ documentId, parentBlockId, index = 0, tableConfig }) => {
+        try {
+            if (!feishuService) {
+                return {
+                    content: [{ type: 'text', text: '飞书服务未初始化，请检查配置' }],
+                };
+            }
+            Logger.info(`开始创建飞书表格，文档ID: ${documentId}，父块ID: ${parentBlockId}，表格大小: ${tableConfig.rowSize}x${tableConfig.columnSize}，插入位置: ${index}`);
+            const result = await feishuService.createTableBlock(documentId, parentBlockId, tableConfig, index);
+            // 构建返回信息
+            let resultText = `表格创建成功！\n\n表格大小: ${tableConfig.rowSize}x${tableConfig.columnSize}\n`;
+            // 如果有图片token，显示图片信息
+            if (result.imageTokens && result.imageTokens.length > 0) {
+                resultText += `\n\n📸 发现 ${result.imageTokens.length} 个图片:\n`;
+                result.imageTokens.forEach((imageToken, index) => {
+                    resultText += `${index + 1}. 坐标(${imageToken.row}, ${imageToken.column}) - blockId: ${imageToken.blockId}\n`;
+                });
+                resultText += "你需要使用upload_and_bind_image_to_block工具绑定图片";
+            }
+            resultText += `\n\n完整结果:\n${JSON.stringify(result, null, 2)}`;
+            return {
+                content: [{
+                        type: 'text',
+                        text: resultText
+                    }],
+            };
+        }
+        catch (error) {
+            Logger.error(`创建飞书表格失败:`, error);
+            const errorMessage = formatErrorMessage(error);
+            return {
+                content: [{ type: 'text', text: `创建飞书表格失败: ${errorMessage}` }],
+            };
+        }
+    });
 }

package/dist/mcp/tools/feishuTools.js

@@ -107,11 +107,14 @@ export function registerFeishuTools(server, feishuService) {
             // 检查是否有 block_type 为 43 的块（画板块）
             const whiteboardBlocks = blocks.filter((block) => block.block_type === 43);
             const hasWhiteboardBlocks = whiteboardBlocks.length > 0;
+            // 检查是否有 block_type 为 27 的块（图片块）
+            const imageBlocks = blocks.filter((block) => block.block_type === 27);
+            const hasImageBlocks = imageBlocks.length > 0;
             let responseText = JSON.stringify(blocks, null, 2);
             if (hasWhiteboardBlocks) {
                 responseText += '\n\n⚠️ 检测到画板块 (block_type: 43)！\n';
-                responseText += `发现 ${whiteboardBlocks.length} 个画板块。画板块包含丰富的图形内容，如形状、文本、思维导图等。\n`;
-                responseText += '建议使用 get_feishu_whiteboard_content 工具来获取画板的具体内容和结构。\n';
+                responseText += `发现 ${whiteboardBlocks.length} 个画板块。\n`;
+                responseText += '💡 提示：如果您需要获取画板的具体内容（如流程图、思维导图等），可以使用 get_feishu_whiteboard_content 工具。\n';
                 responseText += '画板信息:\n';
                 whiteboardBlocks.forEach((block, index) => {
                     responseText += `  ${index + 1}. 块ID: ${block.block_id}`;
@@ -120,7 +123,21 @@ export function registerFeishuTools(server, feishuService) {
                     }
                     responseText += '\n';
                 });
-                responseText += '请使用上述画板ID调用 get_feishu_whiteboard_content 工具。';
+                responseText += '📝 注意：只有在需要分析画板内容时才调用上述工具，仅了解文档结构时无需获取。';
+            }
+            if (hasImageBlocks) {
+                responseText += '\n\n🖼️ 检测到图片块 (block_type: 27)！\n';
+                responseText += `发现 ${imageBlocks.length} 个图片块。\n`;
+                responseText += '💡 提示：如果您需要查看图片的具体内容，可以使用 get_feishu_image_resource 工具下载图片。\n';
+                responseText += '图片信息:\n';
+                imageBlocks.forEach((block, index) => {
+                    responseText += `  ${index + 1}. 块ID: ${block.block_id}`;
+                    if (block.image && block.image.token) {
+                        responseText += `, 媒体ID: ${block.image.token}`;
+                    }
+                    responseText += '\n';
+                });
+                responseText += '📝 注意：只有在需要查看图片内容时才调用上述工具，仅了解文档结构时无需获取。';
             }
             return {
                 content: [{ type: 'text', text: responseText }],

package/dist/services/baseService.js

@@ -2,6 +2,8 @@ import axios, { AxiosError } from 'axios';
 import FormData from 'form-data';
 import { Logger } from '../utils/logger.js';
 import { formatErrorMessage } from '../utils/error.js';
+import { CacheManager } from '../utils/cache.js';
+import { Config } from '../utils/config.js';
 /**
  * API服务基类
  * 提供通用的HTTP请求处理和认证功能
@@ -135,7 +137,9 @@ export class BaseApiService {
                 // 清除当前令牌，下次请求会重新获取
                 this.accessToken = '';
                 this.tokenExpireTime = null;
-                Logger.warn('访问令牌可能已过期，已清除缓存的令牌');
+                Logger.warn(`访问令牌可能已过期，已清除缓存的令牌`);
+                const clientKey = await CacheManager.getClientKey(Config.getInstance().feishu.appId, Config.getInstance().feishu.appSecret);
+                CacheManager.getInstance().removeUserToken(clientKey);
                 // 如果这是重试请求，避免无限循环
                 if (error.isRetry) {
                     this.handleApiError(error, `API请求失败 (${endpoint})`);

package/dist/services/blockFactory.js

@@ -246,4 +246,92 @@ export class BlockFactory {
             },
         };
     }
+    /**
+     * 创建表格块
+     * @param options 表格块选项
+     * @returns 表格块内容对象
+     */
+    createTableBlock(options) {
+        const { columnSize, rowSize, cells = [] } = options;
+        // 生成表格ID
+        const tableId = `table_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+        const imageBlocks = Array();
+        // 创建表格单元格
+        const tableCells = [];
+        const descendants = [];
+        for (let row = 0; row < rowSize; row++) {
+            for (let col = 0; col < columnSize; col++) {
+                const cellId = `table_cell${row}_${col}`;
+                // 查找是否有配置的单元格内容
+                const cellConfigs = cells.filter(cell => cell.coordinate.row === row && cell.coordinate.column === col);
+                // 创建单元格内容
+                const cellContentBlocks = [];
+                const cellContentIds = [];
+                if (cellConfigs.length > 0) {
+                    // 处理多个内容块
+                    cellConfigs.forEach((cellConfig, index) => {
+                        const cellContentId = `${cellId}_child_${index}`;
+                        const cellContentBlock = {
+                            block_id: cellContentId,
+                            ...cellConfig.content,
+                            children: []
+                        };
+                        cellContentBlocks.push(cellContentBlock);
+                        cellContentIds.push(cellContentId);
+                        Logger.info(`处理块：${JSON.stringify(cellConfig)}  ${index}`);
+                        if (cellConfig.content.block_type === 27) {
+                            //把图片块保存起来，用于后续获取该图片块的token
+                            imageBlocks.push({
+                                coordinate: cellConfig.coordinate,
+                                localBlockId: cellContentId,
+                            });
+                        }
+                    });
+                }
+                else {
+                    // 创建空的文本块
+                    const cellContentId = `${cellId}_child`;
+                    const cellContentBlock = {
+                        block_id: cellContentId,
+                        ...this.createTextBlock({
+                            textContents: [{ text: "" }]
+                        }),
+                        children: []
+                    };
+                    cellContentBlocks.push(cellContentBlock);
+                    cellContentIds.push(cellContentId);
+                }
+                // 创建表格单元格块
+                const tableCell = {
+                    block_id: cellId,
+                    block_type: 32, // 表格单元格类型
+                    table_cell: {},
+                    children: cellContentIds
+                };
+                tableCells.push(cellId);
+                descendants.push(tableCell);
+                descendants.push(...cellContentBlocks);
+            }
+        }
+        // 创建表格主体
+        const tableBlock = {
+            block_id: tableId,
+            block_type: 31, // 表格块类型
+            table: {
+                property: {
+                    row_size: rowSize,
+                    column_size: columnSize
+                }
+            },
+            children: tableCells
+        };
+        descendants.unshift(tableBlock);
+        // 过滤并记录 block_type 为 27 的元素
+        Logger.info(`发现 ${imageBlocks.length} 个图片块 (block_type: 27):  ${JSON.stringify(imageBlocks)}`);
+        return {
+            children_id: [tableId],
+            descendants: descendants,
+            imageBlocks: imageBlocks
+        };
+    }
 }

package/dist/services/feishuApiService.js

@@ -411,6 +411,91 @@ export class FeishuApiService extends BaseApiService {
         const response = await this.post(endpoint, payload);
         return response;
     }
+    /**
+     * 创建表格块
+     * @param documentId 文档ID或URL
+     * @param parentBlockId 父块ID
+     * @param tableConfig 表格配置
+     * @param index 插入位置索引
+     * @returns 创建结果
+     */
+    async createTableBlock(documentId, parentBlockId, tableConfig, index = 0) {
+        const normalizedDocId = ParamUtils.processDocumentId(documentId);
+        const endpoint = `/docx/v1/documents/${normalizedDocId}/blocks/${parentBlockId}/descendant?document_revision_id=-1`;
+        // 处理表格配置，为每个单元格创建正确的内容块
+        const processedTableConfig = {
+            ...tableConfig,
+            cells: tableConfig.cells?.map(cell => ({
+                ...cell,
+                content: this.createBlockContent(cell.content.blockType, cell.content.options)
+            }))
+        };
+        // 使用 BlockFactory 创建表格块内容
+        const tableStructure = this.blockFactory.createTableBlock(processedTableConfig);
+        const payload = {
+            children_id: tableStructure.children_id,
+            descendants: tableStructure.descendants,
+            index
+        };
+        Logger.info(`请求创建表格块: ${tableConfig.rowSize}x${tableConfig.columnSize}，单元格数量: ${tableConfig.cells?.length || 0}`);
+        const response = await this.post(endpoint, payload);
+        // 创建表格成功后，获取单元格中的图片token
+        const imageTokens = await this.extractImageTokensFromTable(response, tableStructure.imageBlocks);
+        return {
+            ...response,
+            imageTokens: imageTokens
+        };
+    }
+    /**
+     * 从表格中提取图片块信息（优化版本）
+     * @param tableResponse 创建表格的响应数据
+     * @param cells 表格配置，包含原始cells信息
+     * @returns 图片块信息数组，包含坐标和块ID信息
+     */
+    async extractImageTokensFromTable(tableResponse, cells) {
+        try {
+            const imageTokens = [];
+            Logger.info(`tableResponse: ${JSON.stringify(tableResponse)}`);
+            // 判断 cells 是否为空
+            if (!cells || cells.length === 0) {
+                Logger.info('表格中没有图片单元格，跳过图片块信息提取');
+                return imageTokens;
+            }
+            // 创建 localBlockId 到 block_id 的映射
+            const blockIdMap = new Map();
+            if (tableResponse && tableResponse.block_id_relations) {
+                for (const relation of tableResponse.block_id_relations) {
+                    blockIdMap.set(relation.temporary_block_id, relation.block_id);
+                }
+                Logger.debug(`创建了 ${blockIdMap.size} 个块ID映射关系`);
+            }
+            // 遍历所有图片单元格
+            for (const cell of cells) {
+                const { coordinate, localBlockId } = cell;
+                const { row, column } = coordinate;
+                // 根据 localBlockId 在创建表格的返回数据中找到 block_id
+                const blockId = blockIdMap.get(localBlockId);
+                if (!blockId) {
+                    Logger.warn(`未找到 localBlockId ${localBlockId} 对应的 block_id`);
+                    continue;
+                }
+                Logger.debug(`处理单元格 (${row}, ${column})，localBlockId: ${localBlockId}，blockId: ${blockId}`);
+                // 直接添加块信息
+                imageTokens.push({
+                    row,
+                    column,
+                    blockId
+                });
+                Logger.info(`提取到图片块信息: 位置(${row}, ${column})，blockId: ${blockId}`);
+            }
+            Logger.info(`成功提取 ${imageTokens.length} 个图片块信息`);
+            return imageTokens;
+        }
+        catch (error) {
+            Logger.error(`提取表格图片块信息失败: ${error}`);
+            return [];
+        }
+    }
     /**
      * 删除文档中的块，支持批量删除
      * @param documentId 文档ID或URL

package/dist/types/feishuSchema.js

@@ -137,6 +137,33 @@ export const BlockConfigSchema = z.object({
         z.record(z.any()).describe("Fallback for any other block options")
     ]).describe('Options for the specific block type. Provide the corresponding options object based on blockType.'),
 });
+// 表格列数参数定义
+export const TableColumnSizeSchema = z.number().min(1).describe('Table column size (required). The number of columns in the table. Must be at least 1.');
+// 表格行数参数定义
+export const TableRowSizeSchema = z.number().min(1).describe('Table row size (required). The number of rows in the table. Must be at least 1.');
+// 表格单元格坐标参数定义
+export const TableCellCoordinateSchema = z.object({
+    row: z.number().min(0).describe('Row coordinate (0-based). The row position of the cell in the table.'),
+    column: z.number().min(0).describe('Column coordinate (0-based). The column position of the cell in the table.')
+});
+// 表格单元格内容配置定义
+export const TableCellContentSchema = z.object({
+    coordinate: TableCellCoordinateSchema,
+    content: BlockConfigSchema
+});
+// 表格创建参数定义 - 专门用于创建表格块工具
+export const TableCreateSchema = z.object({
+    columnSize: TableColumnSizeSchema,
+    rowSize: TableRowSizeSchema,
+    cells: z.array(TableCellContentSchema).optional().describe('Array of cell configurations (optional). Each cell specifies its position (row, column) and content block configuration. ' +
+        'If not provided, empty text blocks will be created for all cells. ' +
+        'IMPORTANT: Multiple cells can have the same coordinates (row, column) - when this happens, ' +
+        'the content blocks will be added sequentially to the same cell, allowing you to create rich content ' +
+        'with multiple blocks (text, code, images, etc.) within a single cell. ' +
+        'Example: [{coordinate:{row:0,column:0}, content:{blockType:"text", options:{text:{textStyles:[{text:"Header"}]}}}, ' +
+        '{coordinate:{row:0,column:0}, content:{blockType:"code", options:{code:{code:"console.log(\'hello\')", language:30}}}}] ' +
+        'will add both a text block and a code block to cell (0,0).')
+});
 // 媒体ID参数定义
 export const MediaIdSchema = z.string().describe('Media ID (required). The unique identifier for a media resource (image, file, etc.) in Feishu. ' +
     'Usually obtained from image blocks or file references in documents. ' +

package/dist/utils/cache.js

@@ -241,6 +241,9 @@ export class CacheManager {
     getUserToken(key) {
         return this.get(`user_access_token:${key}`);
     }
+    removeUserToken(key) {
+        return this.delete(`user_access_token:${key}`);
+    }
     /**
      * 缓存访问令牌
      * @param token 访问令牌

package/package.json

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