@lobehub/chat 1.84.7 → 1.84.8

package/CHANGELOG.md

@@ -2,6 +2,31 @@
 
 # Changelog
 
+### [Version 1.84.8](https://github.com/lobehub/lobe-chat/compare/v1.84.7...v1.84.8)
+
+<sup>Released on **2025-04-29**</sup>
+
+#### 🐛 Bug Fixes
+
+- **misc**: Fix stdio mcp server env issue.
+
+<br/>
+
+<details>
+<summary><kbd>Improvements and Fixes</kbd></summary>
+
+#### What's fixed
+
+- **misc**: Fix stdio mcp server env issue, closes [#7648](https://github.com/lobehub/lobe-chat/issues/7648) ([bad222a](https://github.com/lobehub/lobe-chat/commit/bad222a))
+
+</details>
+
+<div align="right">
+
+[![](https://img.shields.io/badge/-BACK_TO_TOP-151515?style=flat-square)](#readme-top)
+
+</div>
+
 ### [Version 1.84.7](https://github.com/lobehub/lobe-chat/compare/v1.84.6...v1.84.7)
 
 <sup>Released on **2025-04-29**</sup>

package/apps/desktop/src/main/controllers/SystemCtr.ts

@@ -1,5 +1,5 @@
 import { ElectronAppState } from '@lobechat/electron-client-ipc';
-import { app, systemPreferences } from 'electron';
+import { app, shell, systemPreferences } from 'electron';
 import { macOS } from 'electron-is';
 import { readFileSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
@@ -49,6 +49,11 @@ export default class SystemController extends ControllerModule {
     return systemPreferences.isTrustedAccessibilityClient(true);
   }
 
+  @ipcClientEvent('openExternalLink')
+  openExternalLink(url: string) {
+    return shell.openExternal(url);
+  }
+
   /**
    * 更新应用语言设置
    */

package/apps/desktop/src/preload/routeInterceptor.ts

@@ -34,12 +34,23 @@ export const setupRouteInterceptors = function () {
         try {
           const url = new URL(link.href);
 
+          // 检查是否为外部链接
+          if (url.origin !== window.location.origin) {
+            console.log(`[preload] Intercepted external link click:`, url.href);
+            // 阻止默认的链接跳转行为
+            e.preventDefault();
+            e.stopPropagation();
+            // 调用主进程处理外部链接
+            await invoke('openExternalLink', url.href);
+            return false; // 明确阻止后续处理
+          }
+
+          // 如果不是外部链接，则继续处理内部路由拦截逻辑
           // 使用共享配置检查是否需要拦截
           const matchedRoute = findMatchingRoute(url.pathname);
 
-          // 如果是需要拦截的路径，立即阻止默认行为
+          // 如果是需要拦截的路径
           if (matchedRoute) {
-            // 检查当前页面是否已经在目标路径下，如果是则不拦截
             const currentPath = window.location.pathname;
             const isAlreadyInTargetPage = currentPath.startsWith(matchedRoute.pathPrefix);
 
@@ -55,7 +66,18 @@ export const setupRouteInterceptors = function () {
             return false;
           }
         } catch (err) {
-          console.error('[preload] Link interception error:', err);
+          // 处理可能的 URL 解析错误或其他问题
+          // 例如 mailto:, tel: 等协议会导致 new URL() 抛出错误
+          if (err instanceof TypeError && err.message.includes('Invalid URL')) {
+            console.log(
+              '[preload] Non-HTTP link clicked, allowing default browser behavior:',
+              link.href,
+            );
+            // 对于非 HTTP/HTTPS 链接，允许浏览器默认处理
+            // 不需要 e.preventDefault() 或 invoke
+          } else {
+            console.error('[preload] Link interception error:', err);
+          }
         }
       }
     },

package/changelog/v1.json

@@ -1,4 +1,13 @@
 [
+  {
+    "children": {
+      "fixes": [
+        "Fix stdio mcp server env issue."
+      ]
+    },
+    "date": "2025-04-29",
+    "version": "1.84.8"
+  },
   {
     "children": {
       "fixes": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lobehub/chat",
-  "version": "1.84.7",
+  "version": "1.84.8",
   "description": "Lobe Chat - an open-source, high-performance chatbot framework that supports speech synthesis, multimodal, and extensible Function Call plugin system. Supports one-click free deployment of your private ChatGPT/LLM web application.",
   "keywords": [
     "framework",

package/packages/electron-client-ipc/src/events/system.ts

@@ -3,6 +3,7 @@ import { ElectronAppState } from '../types';
 export interface SystemDispatchEvents {
   checkSystemAccessibility: () => boolean | undefined;
   getDesktopAppState: () => ElectronAppState;
+  openExternalLink: (url: string) => void;
   /**
    * 更新应用语言设置
    * @param locale 语言设置

package/src/features/PluginDevModal/MCPManifestForm/index.tsx

@@ -165,10 +165,10 @@ const MCPManifestForm = ({ form, isEditMode }: MCPManifestFormProps) => {
       } else if (mcp.type === 'stdio') {
         if (!mcp.command) throw new Error(t('dev.mcp.command.required'));
         if (!mcp.args) throw new Error(t('dev.mcp.args.required'));
-        data = await mcpService.getStdioMcpServerManifest(id, mcp.command, mcp.args, {
-          avatar,
-          description,
-        });
+        data = await mcpService.getStdioMcpServerManifest(
+          { ...mcp, name: id },
+          { avatar, description },
+        );
       } else {
         throw new Error('Invalid MCP type'); // Internal error
       }

package/src/libs/mcp/client.ts

@@ -5,6 +5,7 @@ import {
 } from '@modelcontextprotocol/sdk/client/stdio.js';
 import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
 import type { Transport } from '@modelcontextprotocol/sdk/shared/transport.d.ts';
+import type { Progress } from '@modelcontextprotocol/sdk/types.js';
 import debug from 'debug';
 
 import { MCPClientParams, McpTool } from './types';
@@ -46,10 +47,20 @@ export class MCPClient {
     }
   }
 
-  async initialize() {
+  async initialize(options: { onProgress?: (progress: Progress) => void } = {}) {
     log('Initializing MCP connection...');
-    await this.mcp.connect(this.transport);
-    log('MCP connection initialized.');
+
+    try {
+      await this.mcp.connect(this.transport, { onprogress: options.onProgress });
+      log('MCP connection initialized.');
+    } catch (e) {
+      if ((e as any).code === -32_000) {
+        throw new Error('Fail to connecting MCP Server, please check your configuration.');
+      }
+
+      log('MCP connection failed:', e);
+      throw e;
+    }
   }
 
   async disconnect() {

package/src/server/routers/desktop/mcp.ts

@@ -1,3 +1,4 @@
+import debug from 'debug';
 import { z } from 'zod';
 
 import { isServerMode } from '@/const/version';
@@ -5,9 +6,12 @@ import { passwordProcedure } from '@/libs/trpc/edge';
 import { authedProcedure, router } from '@/libs/trpc/lambda';
 import { mcpService } from '@/server/services/mcp';
 
+const log = debug('lobe-mcp:router');
+
 const stdioParamsSchema = z.object({
   args: z.array(z.string()).optional().default([]),
   command: z.string().min(1),
+  env: z.any().optional(),
   metadata: z
     .object({
       avatar: z.string().optional(),
@@ -22,10 +26,9 @@ const mcpProcedure = isServerMode ? authedProcedure : passwordProcedure;
 
 export const mcpRouter = router({
   getStdioMcpServerManifest: mcpProcedure.input(stdioParamsSchema).query(async ({ input }) => {
-    return await mcpService.getStdioMcpServerManifest(
-      { args: input.args, command: input.command, name: input.name },
-      input.metadata,
-    );
+    log('getStdioMcpServerManifest input: %O', input);
+
+    return await mcpService.getStdioMcpServerManifest(input, input.metadata);
   }),
 
   /* eslint-disable sort-keys-fix/sort-keys-fix */

package/src/server/services/mcp/index.ts

@@ -119,7 +119,11 @@ class MCPService {
       // }
 
       const client = new MCPClient(params);
-      await client.initialize(); // Initialization logic should be within MCPClient
+      await client.initialize({
+        onProgress: (progress) => {
+          log(`New client initializing... ${progress.progress}/${progress.total}`);
+        },
+      }); // Initialization logic should be within MCPClient
       this.clients.set(key, client);
       log(`New client initialized and cached for key: ${key}`);
       return client;
@@ -129,7 +133,7 @@ class MCPService {
       throw new TRPCError({
         cause: error,
         code: 'INTERNAL_SERVER_ERROR',
-        message: `Failed to initialize MCP client: ${(error as Error).message}`,
+        message: `Failed to initialize MCP client, reason: ${(error as Error).message}`,
       });
     }
   }
@@ -181,6 +185,7 @@ class MCPService {
     const tools = await this.listTools({
       args: params.args,
       command: params.command,
+      env: params.env,
       name: params.name,
       type: 'stdio',
     });

package/src/services/mcp.ts

@@ -40,17 +40,15 @@ class MCPService {
   }
 
   async getStdioMcpServerManifest(
-    identifier: string,
-    command: string,
-    args?: string[],
+    stdioParams: {
+      args?: string[];
+      command: string;
+      env?: Record<string, string>;
+      name: string;
+    },
     metadata?: CustomPluginMetadata,
   ) {
-    return desktopClient.mcp.getStdioMcpServerManifest.query({
-      args: args,
-      command,
-      metadata,
-      name: identifier,
-    });
+    return desktopClient.mcp.getStdioMcpServerManifest.query({ ...stdioParams, metadata });
   }
 }
 

package/src/types/tool/plugin.ts

@@ -22,6 +22,7 @@ export interface CustomPluginParams {
    */
   mcp?: {
     args?: string[];
+    env?: Record<string, string>;
     command?: string;
     type: 'http' | 'stdio';
     url?: string;