feishu-mcp 0.1.7 → 0.1.9-test.1

package/dist/types/feishuSchema.js

@@ -1,9 +1,12 @@
 import { z } from 'zod';
-// 文档ID或URL参数定义
+// 文档类型枚举（用于 get_feishu_document_info）
+export const DocumentTypeSchema = z.enum(['document', 'wiki']).optional().describe('Document type (optional). "document" for regular document, "wiki" for Wiki document.');
+// 文档ID或URL参数定义（仅支持普通文档）
 export const DocumentIdSchema = z.string().describe('Document ID or URL (required). Supports the following formats:\n' +
     '1. Standard document URL: https://xxx.feishu.cn/docs/xxx or https://xxx.feishu.cn/docx/xxx\n' +
-    '2. Direct document ID: e.g., JcKbdlokYoPIe0xDzJ1cduRXnRf\n' +
-    'Note: Wiki links require conversion with convert_feishu_wiki_to_document_id first.');
+    '2. Direct document ID: e.g., JcKbdlokYoPIe0xDzJ1cduRXnRf');
+// 文档ID或Wiki ID参数定义（用于 get_feishu_document_info，支持普通文档和Wiki文档）
+export const DocumentIdOrWikiIdSchema = z.string().describe('Document ID, URL, or Wiki ID/URL (required). Supports regular document formats (https://xxx.feishu.cn/docx/xxx or direct ID) and Wiki formats (https://xxx.feishu.cn/wiki/xxxxx or Wiki token).');
 // 父块ID参数定义
 export const ParentBlockIdSchema = 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. ' +
@@ -179,13 +182,36 @@ export const MediaIdSchema = z.string().describe('Media ID (required). The uniqu
 // 额外参数定义 - 用于媒体资源下载
 export const MediaExtraSchema = z.string().optional().describe('Extra parameters for media download (optional). ' +
     'These parameters are passed directly to the Feishu API and can modify how the media is returned.');
-// 文件夹Token参数定义
+// 文件夹Token参数定义（必传）
 export const FolderTokenSchema = z.string().describe('Folder token (required). The unique identifier for a folder in Feishu. ' +
     'Format is an alphanumeric string like "FWK2fMleClICfodlHHWc4Mygnhb".');
+// 文件夹Token参数定义（可选，用于文档创建、获取文件列表等场景）
+export const FolderTokenOptionalSchema = z.string().optional().describe('Folder token (optional, for Feishu Drive folder mode). The unique identifier for a folder in Feishu Drive. ' +
+    'Format is an alphanumeric string like "FWK2fMleClICfodlHHWc4Mygnhb". ');
 // 文件夹名称参数定义
 export const FolderNameSchema = z.string().describe('Folder name (required). The name for the new folder to be created.');
+// 知识空间ID参数定义
+export const SpaceIdSchema = z.string().describe('Space ID (optional, required for wiki space mode). The unique identifier for a wiki space in Feishu. ' +
+    'Can be obtained from get_feishu_root_folder_info (wiki_spaces array or my_library.space_id). ' +
+    'Format is typically like "74812***88644".');
+// 父节点Token参数定义
+export const ParentNodeTokenSchema = z.string().optional().describe('Parent node token (optional, used with spaceId). The token of the parent node in a wiki space. ' +
+    'If not provided or empty, will retrieve nodes from the root of the wiki space. ' +
+    'Format is typically like "PdDWwIHD6****MhcIOY7npg".');
+// 知识库节点上下文参数定义（包装 spaceId 和 parentNodeToken）
+export const WikiSpaceNodeContextSchema = z.object({
+    spaceId: SpaceIdSchema.optional(),
+    parentNodeToken: ParentNodeTokenSchema,
+}).optional().describe('Wiki space node context object. Contains spaceId (required when using this object) and optional parentNodeToken. ' +
+    'Used for wiki space operations instead of folderToken.');
 // 搜索关键字参数定义
 export const SearchKeySchema = z.string().describe('Search keyword (required). The keyword to search for in documents.');
+// 搜索类型枚举
+export const SearchTypeSchema = z.enum(['document', 'wiki', 'both']).optional().default('both').describe('Search type (optional, default: "both"). "document": only documents, "wiki": only wiki nodes, "both": both (default)');
+// 知识库分页token参数定义
+export const PageTokenSchema = z.string().optional().describe('Wiki page token (optional). Token from previous wiki search result for pagination. Only needed when fetching next page of wiki results.');
+// 文档分页偏移量参数定义
+export const OffsetSchema = z.number().optional().describe('Document offset (optional). Offset for document search pagination. Only needed when fetching next page of document results.');
 // 图片路径或URL参数定义
 export const ImagePathOrUrlSchema = z.string().describe('Image path or URL (required). Supports the following formats:\n' +
     '1. Local file absolute path: e.g., "C:\\path\\to\\image.jpg"\n' +

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/package.json

@@ -1,75 +1,76 @@
-{
-  "name": "feishu-mcp",
-  "version": "0.1.7",
-  "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:"
-    }
-  }
-}
+{
+  "name": "feishu-mcp",
+  "version": "0.1.9-test.1",
+  "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",
+    "pub:test": "pnpm build && npm publish --tag test"
+  },
+  "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:"
+    }
+  }
+}