feishu-mcp 0.1.6 → 0.1.7

package/dist/utils/auth/tokenCacheManager.js

@@ -28,9 +28,16 @@ export class TokenCacheManager {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "scopeVersionCacheFile", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         this.cache = new Map();
         this.userTokenCacheFile = path.resolve(process.cwd(), 'user_token_cache.json');
         this.tenantTokenCacheFile = path.resolve(process.cwd(), 'tenant_token_cache.json');
+        this.scopeVersionCacheFile = path.resolve(process.cwd(), 'scope_version_cache.json');
         this.loadTokenCaches();
         this.startCacheCleanupTimer();
     }
@@ -49,6 +56,7 @@ export class TokenCacheManager {
     loadTokenCaches() {
         this.loadUserTokenCache();
         this.loadTenantTokenCache();
+        this.loadScopeVersionCache();
     }
     /**
      * 加载用户token缓存
@@ -433,4 +441,108 @@ export class TokenCacheManager {
         Logger.debug(`获取到 ${keys.length} 个用户token keys`);
         return keys;
     }
+    /**
+     * 获取scope版本信息
+     * @param clientKey 客户端缓存键
+     * @returns scope版本信息，如果未找到则返回null
+     */
+    getScopeVersionInfo(clientKey) {
+        const cacheKey = `scope_version:${clientKey}`;
+        const cacheItem = this.cache.get(cacheKey);
+        if (!cacheItem) {
+            Logger.debug(`Scope版本信息未找到: ${clientKey}`);
+            return null;
+        }
+        Logger.debug(`获取Scope版本信息成功: ${clientKey}`);
+        return cacheItem.data;
+    }
+    /**
+     * 保存scope版本信息
+     * @param clientKey 客户端缓存键
+     * @param scopeVersionInfo scope版本信息
+     * @returns 是否成功保存
+     */
+    saveScopeVersionInfo(clientKey, scopeVersionInfo) {
+        try {
+            const cacheKey = `scope_version:${clientKey}`;
+            const now = Date.now();
+            // scope版本信息永久有效，不设置过期时间
+            const cacheItem = {
+                data: scopeVersionInfo,
+                timestamp: now,
+                expiresAt: Number.MAX_SAFE_INTEGER // 永久有效
+            };
+            this.cache.set(cacheKey, cacheItem);
+            this.saveScopeVersionCache();
+            Logger.debug(`Scope版本信息保存成功: ${clientKey}, 版本: ${scopeVersionInfo.scopeVersion}`);
+            return true;
+        }
+        catch (error) {
+            Logger.error(`保存Scope版本信息失败: ${clientKey}`, error);
+            return false;
+        }
+    }
+    /**
+     * 检查scope版本是否需要校验
+     * @param clientKey 客户端缓存键
+     * @param currentScopeVersion 当前scope版本号
+     * @returns 是否需要校验
+     */
+    shouldValidateScope(clientKey, currentScopeVersion) {
+        const scopeVersionInfo = this.getScopeVersionInfo(clientKey);
+        if (!scopeVersionInfo) {
+            Logger.debug(`Scope版本信息不存在，需要校验: ${clientKey}`);
+            return true;
+        }
+        // 如果版本号不同，需要重新校验
+        if (scopeVersionInfo.validatedVersion !== currentScopeVersion) {
+            Logger.debug(`Scope版本号已更新，需要重新校验: ${clientKey}, 旧版本: ${scopeVersionInfo.validatedVersion}, 新版本: ${currentScopeVersion}`);
+            return true;
+        }
+        Logger.debug(`Scope版本已校验过，无需重复校验: ${clientKey}, 版本: ${currentScopeVersion}`);
+        return false;
+    }
+    /**
+     * 加载scope版本缓存
+     */
+    loadScopeVersionCache() {
+        if (fs.existsSync(this.scopeVersionCacheFile)) {
+            try {
+                const raw = fs.readFileSync(this.scopeVersionCacheFile, 'utf-8');
+                const cacheData = JSON.parse(raw);
+                let loadedCount = 0;
+                for (const key in cacheData) {
+                    if (key.startsWith('scope_version:')) {
+                        this.cache.set(key, cacheData[key]);
+                        loadedCount++;
+                    }
+                }
+                Logger.info(`已加载Scope版本缓存，共 ${loadedCount} 条记录`);
+            }
+            catch (error) {
+                Logger.warn('加载Scope版本缓存失败:', error);
+            }
+        }
+        else {
+            Logger.info('Scope版本缓存文件不存在，将创建新的缓存');
+        }
+    }
+    /**
+     * 保存scope版本缓存到文件
+     */
+    saveScopeVersionCache() {
+        const cacheData = {};
+        for (const [key, value] of this.cache.entries()) {
+            if (key.startsWith('scope_version:')) {
+                cacheData[key] = value;
+            }
+        }
+        try {
+            fs.writeFileSync(this.scopeVersionCacheFile, JSON.stringify(cacheData, null, 2), 'utf-8');
+            Logger.debug('Scope版本缓存已保存到文件');
+        }
+        catch (error) {
+            Logger.warn('保存Scope版本缓存失败:', error);
+        }
+    }
 }

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/error.js

@@ -206,3 +206,27 @@ export class AuthRequiredError extends Error {
         this.message = message;
     }
 }
+/**
+ * 权限不足异常类
+ * 用于处理应用权限范围不足的情况
+ */
+export class ScopeInsufficientError extends Error {
+    constructor(missingScopes, message) {
+        super(message);
+        Object.defineProperty(this, "missingScopes", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "message", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.name = 'ScopeInsufficientError';
+        this.missingScopes = missingScopes;
+        this.message = message;
+    }
+}

package/package.json

@@ -1,75 +1,75 @@
-{
-  "name": "feishu-mcp",
-  "version": "0.1.6",
-  "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.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:"
+    }
+  }
+}