feishu-mcp 0.0.6 → 0.0.7

package/README.md

@@ -153,13 +153,8 @@ bunx feishu-mcp --feishu-app-id=<你的飞书应用ID> --feishu-app-secret=<你
 在飞书开发平台测试权限正常（在开放平台调试，失败时会有充足提示信息和指导）
 
 ### 文档授权
-如遇到权限问题，请参考[云文档常见问题](https://open.feishu.cn/document/ukTMukTMukTM/uczNzUjL3czM14yN3MTN)，特别关注如何为应用或用户开通文档权限。
+如遇到权限问题，请参考[云文档常见问题](https://open.feishu.cn/document/ukTMukTMukTM/uczNzUjL3czM14yN3MTN)、[知识库常见问题](https://open.feishu.cn/document/server-docs/docs/wiki-v2/wiki-qa)，特别关注如何为应用或用户开通文档权限。
 
-## Cursor最佳实践
-
-添加Rules指导模型操作流程
-
-`在将文档上传至飞书时，请遵循以下操作指南：1. 若未特别指定 folderToken，默认为 FPKvf*********6RnOc。2. 在块创建失败的情况下，通过查询文档中所有的块信息，以确认是否确实发生了失败。3. 若需在现有文档中追加信息，请先获取该文档的所有块信息，并根据返回结果确定要插入的内容及其索引位置。4. 一旦文档内容全部修改完成，请提供文档链接,格式如下： https://vq5iay***bc.feishu.cn/docx/documentId。5.获取文档信息时应优先查询其纯文本内容，如果不满足则通过查询所有块来确定内容`
 ## 许可证
 
 MIT

package/dist/config.js

@@ -1,104 +1,26 @@
-import { config } from "dotenv";
-import yargs from "yargs";
-import { hideBin } from "yargs/helpers";
-// 确保在任何配置读取前加载.env文件
-config();
-function maskApiKey(key) {
-    if (key.length <= 4)
-        return "****";
-    return `****${key.slice(-4)}`;
-}
+import { Config, ConfigSource } from './utils/config.js';
+/**
+ * 为了向后兼容，保留getServerConfig函数
+ * 但内部使用Config类
+ * @param isStdioMode 是否在stdio模式下
+ * @returns 服务器配置
+ */
 export function getServerConfig(isStdioMode) {
-    // Parse command line arguments
-    const argv = yargs(hideBin(process.argv))
-        .options({
-        port: {
-            type: "number",
-            description: "Port to run the server on",
-        },
-        "feishu-app-id": {
-            type: "string",
-            description: "Feishu App ID",
-        },
-        "feishu-app-secret": {
-            type: "string",
-            description: "Feishu App Secret",
-        },
-    })
-        .help()
-        .parseSync();
-    const config = {
-        port: 3333,
-        configSources: {
-            port: "default",
-        },
-    };
-    // Handle PORT
-    if (argv.port) {
-        config.port = argv.port;
-        config.configSources.port = "cli";
-    }
-    else if (process.env.PORT) {
-        config.port = parseInt(process.env.PORT, 10);
-        config.configSources.port = "env";
-    }
-    // 在加载环境变量之前添加日志
-    console.log('开始加载环境变量配置...');
-    console.log('当前环境变量 FEISHU_APP_ID:', process.env.FEISHU_APP_ID);
-    console.log('当前环境变量 FEISHU_APP_SECRET:', process.env.FEISHU_APP_SECRET);
-    // Handle Feishu configuration
-    if (argv["feishu-app-id"]) {
-        config.feishuAppId = argv["feishu-app-id"];
-        config.configSources.feishuAppId = "cli";
-        console.log(`飞书应用 ID 来自命令行参数: ${maskApiKey(config.feishuAppId)}`);
-    }
-    else if (process.env.FEISHU_APP_ID) {
-        config.feishuAppId = process.env.FEISHU_APP_ID;
-        config.configSources.feishuAppId = "env";
-        console.log(`飞书应用 ID 来自环境变量: ${maskApiKey(config.feishuAppId)}`);
-    }
-    else {
-        console.log('未提供飞书应用 ID');
-    }
-    if (argv["feishu-app-secret"]) {
-        config.feishuAppSecret = argv["feishu-app-secret"];
-        config.configSources.feishuAppSecret = "cli";
-        console.log(`飞书应用密钥来自命令行参数: ${maskApiKey(config.feishuAppSecret)}`);
-    }
-    else if (process.env.FEISHU_APP_SECRET) {
-        config.feishuAppSecret = process.env.FEISHU_APP_SECRET;
-        config.configSources.feishuAppSecret = "env";
-        console.log(`飞书应用密钥来自环境变量: ${maskApiKey(config.feishuAppSecret)}`);
-    }
-    else {
-        console.log('未提供飞书应用密钥');
-    }
-    // 输出飞书配置状态总结
-    if (config.feishuAppId && config.feishuAppSecret) {
-        console.log('飞书配置已完整提供，服务将被初始化');
-    }
-    else if (config.feishuAppId || config.feishuAppSecret) {
-        console.log('飞书配置不完整，服务将不会初始化');
-    }
-    else {
-        console.log('未提供飞书配置，服务将不会初始化');
-    }
-    // 验证配置
-    if (!config.feishuAppId || !config.feishuAppSecret) {
-        console.error("FEISHU_APP_ID 和 FEISHU_APP_SECRET 是必需的（通过命令行参数 --feishu-app-id 和 --feishu-app-secret 或 .env 文件）");
-        process.exit(1);
-    }
-    // Log configuration sources
+    const config = Config.getInstance();
     if (!isStdioMode) {
-        console.log("\n配置信息:");
-        console.log(`- PORT: ${config.port} (来源: ${config.configSources.port})`);
-        if (config.feishuAppId) {
-            console.log(`- FEISHU_APP_ID: ${maskApiKey(config.feishuAppId)} (来源: ${config.configSources.feishuAppId})`);
-        }
-        if (config.feishuAppSecret) {
-            console.log(`- FEISHU_APP_SECRET: ${maskApiKey(config.feishuAppSecret)} (来源: ${config.configSources.feishuAppSecret})`);
-        }
-        console.log(); // 空行，提高可读性
+        config.printConfig(isStdioMode);
     }
-    return config;
+    // 为了向后兼容，返回旧格式的配置对象
+    return {
+        port: config.server.port,
+        feishuAppId: config.feishu.appId,
+        feishuAppSecret: config.feishu.appSecret,
+        configSources: {
+            port: config.configSources['server.port'].toLowerCase(),
+            feishuAppId: config.configSources['feishu.appId']?.toLowerCase(),
+            feishuAppSecret: config.configSources['feishu.appSecret']?.toLowerCase()
+        }
+    };
 }
+// 导出Config类
+export { Config, ConfigSource };

package/dist/index.js

@@ -1,29 +1,30 @@
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { FeishuMcpServer } from "./server.js";
-import { getServerConfig } from "./config.js";
+import { Config } from "./utils/config.js";
 import { fileURLToPath } from 'url';
 import { resolve } from 'path';
 export async function startServer() {
     // Check if we're running in stdio mode (e.g., via CLI)
     const isStdioMode = process.env.NODE_ENV === "cli" || process.argv.includes("--stdio");
-    const config = getServerConfig(isStdioMode);
-    // 创建飞书配置对象
-    const feishuConfig = {
-        appId: config.feishuAppId,
-        appSecret: config.feishuAppSecret
-    };
-    console.log("Feishu configuration status: Available");
-    console.log(`Feishu App ID: ${feishuConfig.appId.substring(0, 4)}...${feishuConfig.appId.substring(feishuConfig.appId.length - 4)}`);
-    console.log(`Feishu App Secret: ${feishuConfig.appSecret.substring(0, 4)}...${feishuConfig.appSecret.substring(feishuConfig.appSecret.length - 4)}`);
-    const server = new FeishuMcpServer(feishuConfig);
+    // 获取配置实例
+    const config = Config.getInstance();
+    // 打印配置信息
+    config.printConfig(isStdioMode);
+    // 验证配置
+    if (!config.validate()) {
+        console.error("配置验证失败，无法启动服务器");
+        process.exit(1);
+    }
+    // 创建MCP服务器
+    const server = new FeishuMcpServer();
     console.log(`isStdioMode:${isStdioMode}`);
     if (isStdioMode) {
         const transport = new StdioServerTransport();
         await server.connect(transport);
     }
     else {
-        console.log(`Initializing Feishu MCP Server in HTTP mode on port ${config.port}...`);
-        await server.startHttpServer(config.port);
+        console.log(`Initializing Feishu MCP Server in HTTP mode on port ${config.server.port}...`);
+        await server.startHttpServer(config.server.port);
     }
 }
 // 跨平台兼容的方式检查是否直接运行