feishu-mcp 0.1.0 → 0.1.2

package/dist/types/feishuSchema.js

@@ -103,7 +103,7 @@ export const ListBlockSchema = z.object({
     align: AlignSchemaWithValidation,
 });
 // 块类型枚举 - 用于批量创建块工具
-export const BlockTypeEnum = z.string().describe("Block type (required). Supports: 'text', 'code', 'heading', 'list', 'image', as well as 'heading1' through 'heading9'. " +
+export const BlockTypeEnum = z.string().describe("Block type (required). Supports: 'text', 'code', 'heading', 'list', 'image','mermaid',as well as 'heading1' through 'heading9'. " +
     "For headings, we recommend using 'heading' with level property, but 'heading1'-'heading9' are also supported. " +
     "For images, use 'image' to create empty image blocks that can be filled later. " +
     "For text blocks, you can include both regular text and equation elements in the same block.");
@@ -116,6 +116,14 @@ export const ImageBlockSchema = z.object({
     width: ImageWidthSchema,
     height: ImageHeightSchema
 });
+// Mermaid代码参数定义
+export const MermaidCodeSchema = z.string().describe('Mermaid code (required). The complete Mermaid chart code, e.g. \'graph TD; A-->B;\'. ' +
+    'IMPORTANT: When node text contains special characters like parentheses (), brackets [], or arrows -->, ' +
+    'wrap the entire text in double quotes to prevent parsing errors. ' +
+    'Example: A["finish()/返回键"] instead of A[finish()/返回键].');
+export const MermaidBlockSchema = z.object({
+    code: MermaidCodeSchema,
+});
 // 块配置定义 - 用于批量创建块工具
 export const BlockConfigSchema = z.object({
     blockType: BlockTypeEnum,
@@ -125,9 +133,37 @@ export const BlockConfigSchema = z.object({
         z.object({ heading: HeadingBlockSchema }).describe("Heading block options. Used with both 'heading' and 'headingN' formats."),
         z.object({ list: ListBlockSchema }).describe("List block options. Used when blockType is 'list'."),
         z.object({ image: ImageBlockSchema }).describe("Image block options. Used when blockType is 'image'. Creates empty image blocks."),
+        z.object({ mermaid: MermaidBlockSchema }).describe("Mermaid block options.  Used when blockType is 'mermaid'."),
         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/dist/utils/document.js

@@ -136,127 +136,127 @@ export function renderFeishuAuthResultHtml(data) {
         expiresIn = expiresIn - now;
     if (refreshExpiresIn && refreshExpiresIn > 1000000000)
         refreshExpiresIn = refreshExpiresIn - now;
-    const tokenBlock = data && !isError ? `
-    <div class="card">
-      <h3>Token 信息</h3>
-      <ul class="kv-list">
-        <li><b>token_type:</b> <span>${data.token_type || ''}</span></li>
-        <li><b>access_token:</b> <span class="foldable" onclick="toggleFold(this)">点击展开/收起</span><pre class="fold scrollable">${data.access_token || ''}</pre></li>
-        <li><b>expires_in:</b> <span>${formatExpire(expiresIn)}</span></li>
-        <li><b>refresh_token:</b> <span class="foldable" onclick="toggleFold(this)">点击展开/收起</span><pre class="fold scrollable">${data.refresh_token || ''}</pre></li>
-        <li><b>refresh_token_expires_in:</b> <span>${formatExpire(refreshExpiresIn)}</span></li>
-        <li><b>scope:</b> <pre class="scope">${(data.scope || '').replace(/ /g, '\n')}</pre></li>
-      </ul>
-      <div class="success-action">
-        <span class="success-msg">授权成功，继续完成任务</span>
-        <button class="copy-btn" onclick="copySuccessMsg(this)">点击复制到粘贴板</button>
-      </div>
-    </div>
+    const tokenBlock = data && !isError ? `
+    <div class="card">
+      <h3>Token 信息</h3>
+      <ul class="kv-list">
+        <li><b>token_type:</b> <span>${data.token_type || ''}</span></li>
+        <li><b>access_token:</b> <span class="foldable" onclick="toggleFold(this)">点击展开/收起</span><pre class="fold scrollable">${data.access_token || ''}</pre></li>
+        <li><b>expires_in:</b> <span>${formatExpire(expiresIn)}</span></li>
+        <li><b>refresh_token:</b> <span class="foldable" onclick="toggleFold(this)">点击展开/收起</span><pre class="fold scrollable">${data.refresh_token || ''}</pre></li>
+        <li><b>refresh_token_expires_in:</b> <span>${formatExpire(refreshExpiresIn)}</span></li>
+        <li><b>scope:</b> <pre class="scope">${(data.scope || '').replace(/ /g, '\n')}</pre></li>
+      </ul>
+      <div class="success-action">
+        <span class="success-msg">授权成功，继续完成任务</span>
+        <button class="copy-btn" onclick="copySuccessMsg(this)">点击复制到粘贴板</button>
+      </div>
+    </div>
   ` : '';
     let userBlock = '';
     const userInfo = data && data.userInfo && data.userInfo.data;
     if (userInfo) {
-        userBlock = `
-      <div class="card user-card">
-        <div class="avatar-wrap">
-          <img src="${userInfo.avatar_big || userInfo.avatar_thumb || userInfo.avatar_url || ''}" class="avatar" />
-        </div>
-        <div class="user-info">
-          <div class="user-name">${userInfo.name || ''}</div>
-          <div class="user-en">${userInfo.en_name || ''}</div>
-        </div>
-      </div>
+        userBlock = `
+      <div class="card user-card">
+        <div class="avatar-wrap">
+          <img src="${userInfo.avatar_big || userInfo.avatar_thumb || userInfo.avatar_url || ''}" class="avatar" />
+        </div>
+        <div class="user-info">
+          <div class="user-name">${userInfo.name || ''}</div>
+          <div class="user-en">${userInfo.en_name || ''}</div>
+        </div>
+      </div>
     `;
     }
-    const errorBlock = isError ? `
-    <div class="card error-card">
-      <h3>授权失败</h3>
-      <div class="error-msg">${escapeHtml(data.error || '')}</div>
-      <div class="error-code">错误码: ${data.code || ''}</div>
-    </div>
+    const errorBlock = isError ? `
+    <div class="card error-card">
+      <h3>授权失败</h3>
+      <div class="error-msg">${escapeHtml(data.error || '')}</div>
+      <div class="error-code">错误码: ${data.code || ''}</div>
+    </div>
   ` : '';
-    return `
-    <html>
-      <head>
-        <title>飞书授权结果</title>
-        <meta charset="utf-8"/>
-        <meta name="viewport" content="width=device-width,initial-scale=1"/>
-        <style>
-          body { background: #f7f8fa; font-family: 'Segoe UI', Arial, sans-serif; margin:0; padding:0; }
-          .container { max-width: 600px; margin: 40px auto; padding: 16px; }
-          .card { background: #fff; border-radius: 12px; box-shadow: 0 2px 12px #0001; margin-bottom: 24px; padding: 24px 20px; }
-          .user-card { display: flex; align-items: center; gap: 24px; }
-          .avatar-wrap { flex-shrink: 0; }
-          .avatar { width: 96px; height: 96px; border-radius: 50%; box-shadow: 0 2px 8px #0002; display: block; margin: 0 auto; }
-          .user-info { flex: 1; }
-          .user-name { font-size: 1.5em; font-weight: bold; margin-bottom: 4px; }
-          .user-en { color: #888; margin-bottom: 10px; }
-          .kv-list { list-style: none; padding: 0; margin: 0; }
-          .kv-list li { margin-bottom: 6px; word-break: break-all; }
-          .kv-list b { color: #1976d2; }
-          .scope { background: #f0f4f8; border-radius: 4px; padding: 6px; font-size: 0.95em; white-space: pre-line; }
-          .foldable { color: #1976d2; cursor: pointer; text-decoration: underline; margin-left: 8px; }
-          .fold { display: none; background: #f6f6f6; border-radius: 4px; padding: 6px; margin: 4px 0; font-size: 0.92em; max-width: 100%; overflow-x: auto; word-break: break-all; }
-          .scrollable { max-width: 100%; overflow-x: auto; font-family: 'Fira Mono', 'Consolas', 'Menlo', monospace; font-size: 0.93em; }
-          .success-action { margin-top: 18px; display: flex; align-items: center; gap: 16px; }
-          .success-msg { color: #388e3c; font-weight: bold; }
-          .copy-btn { background: #1976d2; color: #fff; border: none; border-radius: 4px; padding: 6px 16px; font-size: 1em; cursor: pointer; transition: background 0.2s; }
-          .copy-btn:hover { background: #125ea2; }
-          .error-card { border-left: 6px solid #e53935; background: #fff0f0; color: #b71c1c; }
-          .error-msg { font-size: 1.1em; margin-bottom: 8px; }
-          .error-code { color: #b71c1c; font-size: 0.95em; }
-          .raw-block { margin-top: 24px; }
-          .raw-toggle { color: #1976d2; cursor: pointer; text-decoration: underline; margin-bottom: 8px; display: inline-block; }
-          .raw-pre { display: none; background: #23272e; color: #fff; border-radius: 6px; padding: 12px; font-size: 0.95em; overflow-x: auto; max-width: 100%; }
-          @media (max-width: 700px) {
-            .container { max-width: 98vw; padding: 4vw; }
-            .card { padding: 4vw 3vw; }
-            .avatar { width: 64px; height: 64px; }
-          }
-        </style>
-        <script>
-          function toggleFold(el) {
-            var pre = el.nextElementSibling;
-            if (pre.style.display === 'block') {
-              pre.style.display = 'none';
-            } else {
-              pre.style.display = 'block';
-            }
-          }
-          function toggleRaw() {
-            var pre = document.getElementById('raw-pre');
-            if (pre.style.display === 'block') {
-              pre.style.display = 'none';
-            } else {
-              pre.style.display = 'block';
-            }
-          }
-          function copySuccessMsg(btn) {
-            var text = '授权成功，继续完成任务';
-            navigator.clipboard.writeText(text).then(function() {
-              btn.innerText = '已复制';
-              btn.disabled = true;
-              setTimeout(function() {
-                btn.innerText = '点击复制到粘贴板';
-                btn.disabled = false;
-              }, 2000);
-            });
-          }
-        </script>
-      </head>
-      <body>
-        <div class="container">
-          <h2 style="margin-bottom:24px;">飞书授权结果</h2>
-          ${errorBlock}
-          ${tokenBlock}
-          ${userBlock}
-          <div class="card raw-block">
-            <span class="raw-toggle" onclick="toggleRaw()">点击展开/收起原始数据</span>
-            <pre id="raw-pre" class="raw-pre">${escapeHtml(JSON.stringify(data, null, 2))}</pre>
-          </div>
-        </div>
-      </body>
-    </html>
+    return `
+    <html>
+      <head>
+        <title>飞书授权结果</title>
+        <meta charset="utf-8"/>
+        <meta name="viewport" content="width=device-width,initial-scale=1"/>
+        <style>
+          body { background: #f7f8fa; font-family: 'Segoe UI', Arial, sans-serif; margin:0; padding:0; }
+          .container { max-width: 600px; margin: 40px auto; padding: 16px; }
+          .card { background: #fff; border-radius: 12px; box-shadow: 0 2px 12px #0001; margin-bottom: 24px; padding: 24px 20px; }
+          .user-card { display: flex; align-items: center; gap: 24px; }
+          .avatar-wrap { flex-shrink: 0; }
+          .avatar { width: 96px; height: 96px; border-radius: 50%; box-shadow: 0 2px 8px #0002; display: block; margin: 0 auto; }
+          .user-info { flex: 1; }
+          .user-name { font-size: 1.5em; font-weight: bold; margin-bottom: 4px; }
+          .user-en { color: #888; margin-bottom: 10px; }
+          .kv-list { list-style: none; padding: 0; margin: 0; }
+          .kv-list li { margin-bottom: 6px; word-break: break-all; }
+          .kv-list b { color: #1976d2; }
+          .scope { background: #f0f4f8; border-radius: 4px; padding: 6px; font-size: 0.95em; white-space: pre-line; }
+          .foldable { color: #1976d2; cursor: pointer; text-decoration: underline; margin-left: 8px; }
+          .fold { display: none; background: #f6f6f6; border-radius: 4px; padding: 6px; margin: 4px 0; font-size: 0.92em; max-width: 100%; overflow-x: auto; word-break: break-all; }
+          .scrollable { max-width: 100%; overflow-x: auto; font-family: 'Fira Mono', 'Consolas', 'Menlo', monospace; font-size: 0.93em; }
+          .success-action { margin-top: 18px; display: flex; align-items: center; gap: 16px; }
+          .success-msg { color: #388e3c; font-weight: bold; }
+          .copy-btn { background: #1976d2; color: #fff; border: none; border-radius: 4px; padding: 6px 16px; font-size: 1em; cursor: pointer; transition: background 0.2s; }
+          .copy-btn:hover { background: #125ea2; }
+          .error-card { border-left: 6px solid #e53935; background: #fff0f0; color: #b71c1c; }
+          .error-msg { font-size: 1.1em; margin-bottom: 8px; }
+          .error-code { color: #b71c1c; font-size: 0.95em; }
+          .raw-block { margin-top: 24px; }
+          .raw-toggle { color: #1976d2; cursor: pointer; text-decoration: underline; margin-bottom: 8px; display: inline-block; }
+          .raw-pre { display: none; background: #23272e; color: #fff; border-radius: 6px; padding: 12px; font-size: 0.95em; overflow-x: auto; max-width: 100%; }
+          @media (max-width: 700px) {
+            .container { max-width: 98vw; padding: 4vw; }
+            .card { padding: 4vw 3vw; }
+            .avatar { width: 64px; height: 64px; }
+          }
+        </style>
+        <script>
+          function toggleFold(el) {
+            var pre = el.nextElementSibling;
+            if (pre.style.display === 'block') {
+              pre.style.display = 'none';
+            } else {
+              pre.style.display = 'block';
+            }
+          }
+          function toggleRaw() {
+            var pre = document.getElementById('raw-pre');
+            if (pre.style.display === 'block') {
+              pre.style.display = 'none';
+            } else {
+              pre.style.display = 'block';
+            }
+          }
+          function copySuccessMsg(btn) {
+            var text = '授权成功，继续完成任务';
+            navigator.clipboard.writeText(text).then(function() {
+              btn.innerText = '已复制';
+              btn.disabled = true;
+              setTimeout(function() {
+                btn.innerText = '点击复制到粘贴板';
+                btn.disabled = false;
+              }, 2000);
+            });
+          }
+        </script>
+      </head>
+      <body>
+        <div class="container">
+          <h2 style="margin-bottom:24px;">飞书授权结果</h2>
+          ${errorBlock}
+          ${tokenBlock}
+          ${userBlock}
+          <div class="card raw-block">
+            <span class="raw-toggle" onclick="toggleRaw()">点击展开/收起原始数据</span>
+            <pre id="raw-pre" class="raw-pre">${escapeHtml(JSON.stringify(data, null, 2))}</pre>
+          </div>
+        </div>
+      </body>
+    </html>
   `;
 }
 function escapeHtml(str) {

package/dist/utils/paramUtils.js

@@ -159,6 +159,44 @@ export class ParamUtils {
         // 限制在1-9范围内
         return Math.max(1, Math.min(9, level));
     }
+    /**
+     * 处理画板ID参数
+     * 验证并规范化画板ID，支持从URL中提取
+     *
+     * @param whiteboardId 画板ID或URL
+     * @returns 规范化的画板ID
+     * @throws 如果画板ID无效则抛出错误
+     */
+    static processWhiteboardId(whiteboardId) {
+        if (!whiteboardId) {
+            throw new ParamValidationError('whiteboardId', '画板ID不能为空');
+        }
+        try {
+            // 从URL中提取画板ID
+            let normalizedWhiteboardId = whiteboardId;
+            if (whiteboardId.includes('feishu.cn/board/')) {
+                // 从URL中提取画板ID
+                const matches = whiteboardId.match(/board\/([^\/\?]+)/);
+                if (matches) {
+                    normalizedWhiteboardId = matches[1];
+                }
+                else {
+                    throw new ParamValidationError('whiteboardId', '无法从URL中提取画板ID');
+                }
+            }
+            // 验证画板ID格式（基本格式检查）
+            if (!/^[a-zA-Z0-9_-]{5,}$/.test(normalizedWhiteboardId)) {
+                throw new ParamValidationError('whiteboardId', '画板ID格式无效');
+            }
+            return normalizedWhiteboardId;
+        }
+        catch (error) {
+            if (error instanceof ParamValidationError) {
+                throw error;
+            }
+            throw new ParamValidationError('whiteboardId', formatErrorMessage(error));
+        }
+    }
     /**
      * 批量处理通用参数
      * 验证并规范化常用参数集

package/package.json

@@ -1,75 +1,75 @@
-{
-  "name": "feishu-mcp",
-  "version": "0.1.0",
-  "description": "Model Context Protocol server for Feishu integration",
-  "type": "module",
-  "main": "dist/index.js",
-  "bin": {
-    "feishu-mcp": "./dist/cli.js"
-  },
-  "files": [
-    "dist",
-    "README.md"
-  ],
-  "scripts": {
-    "build": "tsc && tsc-alias",
-    "type-check": "tsc --noEmit",
-    "start": "node dist/index.js",
-    "start:cli": "cross-env NODE_ENV=cli node dist/index.js",
-    "start:http": "node dist/index.js",
-    "dev": "cross-env NODE_ENV=development tsx watch src/index.ts",
-    "dev:cli": "cross-env NODE_ENV=development tsx watch src/index.ts --stdio",
-    "lint": "eslint . --ext .ts",
-    "format": "prettier --write \"src/**/*.ts\"",
-    "inspect": "pnpx @modelcontextprotocol/inspector",
-    "prepare": "pnpm run build",
-    "pub:release": "pnpm build && npm publish"
-  },
-  "engines": {
-    "node": "^20.17.0"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/cso1z/Feishu-MCP.git"
-  },
-  "keywords": [
-    "feishu",
-    "lark",
-    "mcp",
-    "typescript"
-  ],
-  "author": "cso1z",
-  "license": "MIT",
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.13.1",
-    "@types/yargs": "^17.0.33",
-    "axios": "^1.7.9",
-    "cross-env": "^7.0.3",
-    "dotenv": "^16.4.7",
-    "express": "^4.21.2",
-    "form-data": "^4.0.3",
-    "remeda": "^2.20.1",
-    "yargs": "^17.7.2",
-    "zod": "^3.24.2"
-  },
-  "devDependencies": {
-    "@types/express": "^5.0.0",
-    "@types/jest": "^29.5.11",
-    "@types/node": "^20.17.0",
-    "@typescript-eslint/eslint-plugin": "^8.24.0",
-    "@typescript-eslint/parser": "^8.24.0",
-    "eslint": "^9.20.1",
-    "eslint-config-prettier": "^10.0.1",
-    "jest": "^29.7.0",
-    "prettier": "^3.5.0",
-    "ts-jest": "^29.2.5",
-    "tsc-alias": "^1.8.10",
-    "tsx": "^4.19.2",
-    "typescript": "^5.7.3"
-  },
-  "pnpm": {
-    "overrides": {
-      "feishu-mcp": "link:"
-    }
-  }
-}
+{
+  "name": "feishu-mcp",
+  "version": "0.1.2",
+  "description": "Model Context Protocol server for Feishu integration",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "feishu-mcp": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc && tsc-alias",
+    "type-check": "tsc --noEmit",
+    "start": "node dist/index.js",
+    "start:cli": "cross-env NODE_ENV=cli node dist/index.js",
+    "start:http": "node dist/index.js",
+    "dev": "cross-env NODE_ENV=development tsx watch src/index.ts",
+    "dev:cli": "cross-env NODE_ENV=development tsx watch src/index.ts --stdio",
+    "lint": "eslint . --ext .ts",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "inspect": "pnpx @modelcontextprotocol/inspector",
+    "prepare": "pnpm run build",
+    "pub:release": "pnpm build && npm publish"
+  },
+  "engines": {
+    "node": "^20.17.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/cso1z/Feishu-MCP.git"
+  },
+  "keywords": [
+    "feishu",
+    "lark",
+    "mcp",
+    "typescript"
+  ],
+  "author": "cso1z",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.17.5",
+    "@types/yargs": "^17.0.33",
+    "axios": "^1.7.9",
+    "cross-env": "^7.0.3",
+    "dotenv": "^16.4.7",
+    "express": "^4.21.2",
+    "form-data": "^4.0.3",
+    "remeda": "^2.20.1",
+    "yargs": "^17.7.2",
+    "zod": "^3.24.2"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.0",
+    "@types/jest": "^29.5.11",
+    "@types/node": "^20.17.0",
+    "@typescript-eslint/eslint-plugin": "^8.24.0",
+    "@typescript-eslint/parser": "^8.24.0",
+    "eslint": "^9.20.1",
+    "eslint-config-prettier": "^10.0.1",
+    "jest": "^29.7.0",
+    "prettier": "^3.5.0",
+    "ts-jest": "^29.2.5",
+    "tsc-alias": "^1.8.10",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.3"
+  },
+  "pnpm": {
+    "overrides": {
+      "feishu-mcp": "link:"
+    }
+  }
+}