@lobehub/lobehub 2.0.0-next.293 → 2.0.0-next.294

package/.github/workflows/release-desktop-beta.yml

@@ -4,7 +4,7 @@ name: Release Desktop Beta
 # Beta/Nightly 频道发版工作流
 # ============================================
 # 触发条件: 发布包含 pre-release 标识的 release
-# 如: v2.0.0-beta.1, v2.0.0-alpha.1, v2.0.0-rc.1, v2.0.0-nightly.xxx
+# 如: v2.0.0-beta.1, v2.0.0-alpha.1, v2.0.0-rc.1, v2.0.0-nightly.xxx, v2.0.0-next.292
 #
 # 注意: Stable 版本 (如 v2.0.0) 由 release-desktop-stable.yml 处理
 # ============================================
@@ -24,10 +24,10 @@ env:
 
 jobs:
   # ============================================
-  # 检查是否为 Beta/Nightly 版本 (排除 Stable)
+  # 检查是否为 Beta/Nightly/Next 版本 (排除 Stable)
   # ============================================
   check-beta:
-    name: Check if Beta/Nightly Release
+    name: Check if Beta/Nightly/Next Release
     runs-on: ubuntu-latest
     outputs:
       is_beta: ${{ steps.check.outputs.is_beta }}
@@ -40,10 +40,10 @@ jobs:
           version="${version#v}"
           echo "version=${version}" >> $GITHUB_OUTPUT
 
-          # Beta/Nightly 版本包含 beta/alpha/rc/nightly
-          if [[ "$version" == *"beta"* ]] || [[ "$version" == *"alpha"* ]] || [[ "$version" == *"rc"* ]] || [[ "$version" == *"nightly"* ]]; then
+          # Beta/Nightly/Next 版本包含 beta/alpha/rc/nightly/next
+          if [[ "$version" == *"beta"* ]] || [[ "$version" == *"alpha"* ]] || [[ "$version" == *"rc"* ]] || [[ "$version" == *"nightly"* ]] || [[ "$version" == *"next"* ]]; then
             echo "is_beta=true" >> $GITHUB_OUTPUT
-            echo "✅ Beta/Nightly release detected: $version"
+            echo "✅ Beta/Nightly/Next release detected: $version"
           else
             echo "is_beta=false" >> $GITHUB_OUTPUT
             echo "⏭️ Skipping: $version is a stable release (handled by release-desktop-stable.yml)"

package/.github/workflows/release-desktop-stable.yml

@@ -3,10 +3,10 @@ name: Release Desktop Stable
 # ============================================
 # Stable 频道发版工作流
 # ============================================
-# 触发条件: 发布不含 pre-release 标识的 release (如 v2.0.0)
+# 触发条件: 发布不含 pre-release 后缀的 release (如 v2.0.0)
 #
 # 与 Beta 的区别:
-#   1. 仅响应 stable 版本 tag (不含 beta/alpha/rc/nightly)
+#   1. 仅响应 stable 版本 tag (不含任何 '-' 后缀)
 #   2. 使用 STABLE 专用的 Umami 配置
 #   3. 额外上传到 S3 更新服务器
 #   4. 构建时注入 UPDATE_SERVER_URL 让客户端从 S3 检查更新
@@ -89,8 +89,8 @@ jobs:
           if [ "${{ github.event_name }}" == "workflow_dispatch" ]; then
             # 手动触发: 使用输入的版本号
             version="${{ inputs.version }}"
+            version="${version#v}"
             echo "is_manual=true" >> $GITHUB_OUTPUT
-            echo "is_stable=true" >> $GITHUB_OUTPUT
             echo "version=${version}" >> $GITHUB_OUTPUT
             echo "release_notes=" >> $GITHUB_OUTPUT
             echo "🔧 Manual trigger: version=${version}"
@@ -106,15 +106,15 @@ jobs:
               printf '%s\n' "$release_body"
               echo "EOF"
             } >> $GITHUB_OUTPUT
+          fi
 
-            # 检查是否为 stable 版本 (不含 beta/alpha/rc/nightly)
-            if [[ "$version" == *"beta"* ]] || [[ "$version" == *"alpha"* ]] || [[ "$version" == *"rc"* ]] || [[ "$version" == *"nightly"* ]]; then
-              echo "is_stable=false" >> $GITHUB_OUTPUT
-              echo "⏭️ Skipping: $version is not a stable release"
-            else
-              echo "is_stable=true" >> $GITHUB_OUTPUT
-              echo "✅ Stable release detected: $version"
-            fi
+          # 检查是否为 stable 版本 (不含任何 '-' 后缀)
+          if [[ "$version" == *"-"* ]]; then
+            echo "is_stable=false" >> $GITHUB_OUTPUT
+            echo "⏭️ Skipping: $version is not a stable release"
+          else
+            echo "is_stable=true" >> $GITHUB_OUTPUT
+            echo "✅ Stable release detected: $version"
           fi
 
   # ============================================

package/CHANGELOG.md

@@ -2,6 +2,33 @@
 
 # Changelog
 
+## [Version 2.0.0-next.294](https://github.com/lobehub/lobe-chat/compare/v2.0.0-next.293...v2.0.0-next.294)
+
+<sup>Released on **2026-01-15**</sup>
+
+#### 🐛 Bug Fixes
+
+- **chat**: Reset activeTopicId when switching agent/group.
+- **mcp**: Fix installation check hanging issue in desktop app.
+
+<br/>
+
+<details>
+<summary><kbd>Improvements and Fixes</kbd></summary>
+
+#### What's fixed
+
+- **chat**: Reset activeTopicId when switching agent/group, closes [#11523](https://github.com/lobehub/lobe-chat/issues/11523) ([fde54b0](https://github.com/lobehub/lobe-chat/commit/fde54b0))
+- **mcp**: Fix installation check hanging issue in desktop app, closes [#11524](https://github.com/lobehub/lobe-chat/issues/11524) ([b9341c3](https://github.com/lobehub/lobe-chat/commit/b9341c3))
+
+</details>
+
+<div align="right">
+
+[![](https://img.shields.io/badge/-BACK_TO_TOP-151515?style=flat-square)](#readme-top)
+
+</div>
+
 ## [Version 2.0.0-next.293](https://github.com/lobehub/lobe-chat/compare/v2.0.0-next.292...v2.0.0-next.293)
 
 <sup>Released on **2026-01-15**</sup>

package/apps/desktop/electron.vite.config.ts

@@ -21,7 +21,6 @@ export default defineConfig({
       },
       sourcemap: isDev ? 'inline' : false,
     },
-
     define: {
       'process.env.NODE_ENV': JSON.stringify(process.env.NODE_ENV),
       'process.env.UPDATE_CHANNEL': JSON.stringify(process.env.UPDATE_CHANNEL),

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

@@ -7,7 +7,7 @@ import superjson from 'superjson';
 import FileService from '@/services/fileSrv';
 import { createLogger } from '@/utils/logger';
 
-import { MCPClient } from '../libs/mcp/client';
+import { MCPClient, MCPConnectionError } from '../libs/mcp/client';
 import type { MCPClientParams, ToolCallContent, ToolCallResult } from '../libs/mcp/types';
 import { ControllerModule, IpcMethod } from './index';
 
@@ -228,8 +228,9 @@ export default class McpCtr extends ControllerModule {
       type: 'stdio',
     };
 
-    const client = await this.createClient(params);
+    let client: MCPClient | undefined;
     try {
+      client = await this.createClient(params);
       const manifest = await client.listManifests();
       const identifier = input.name;
 
@@ -257,8 +258,25 @@ export default class McpCtr extends ControllerModule {
         mcpParams: params,
         type: 'mcp' as any,
       });
+    } catch (error) {
+      // If it's an MCPConnectionError with stderr logs, enhance the error message
+      if (error instanceof MCPConnectionError && error.stderrLogs.length > 0) {
+        const stderrOutput = error.stderrLogs.join('\n');
+        const enhancedError = new Error(
+          `${error.message}\n\n--- STDIO Process Output ---\n${stderrOutput}`,
+        );
+        enhancedError.name = error.name;
+        logger.error('getStdioMcpServerManifest failed with STDIO logs:', {
+          message: error.message,
+          stderrLogs: error.stderrLogs,
+        });
+        throw enhancedError;
+      }
+      throw error;
     } finally {
-      await client.disconnect();
+      if (client) {
+        await client.disconnect();
+      }
     }
   }
 
@@ -313,8 +331,9 @@ export default class McpCtr extends ControllerModule {
       type: 'stdio',
     };
 
-    const client = await this.createClient(params);
+    let client: MCPClient | undefined;
     try {
+      client = await this.createClient(params);
       const args = safeParseToRecord(input.args);
 
       const raw = (await client.callTool(input.toolName, args)) as ToolCallResult;
@@ -328,10 +347,25 @@ export default class McpCtr extends ControllerModule {
         success: true,
       });
     } catch (error) {
+      // If it's an MCPConnectionError with stderr logs, enhance the error message
+      if (error instanceof MCPConnectionError && error.stderrLogs.length > 0) {
+        const stderrOutput = error.stderrLogs.join('\n');
+        const enhancedError = new Error(
+          `${error.message}\n\n--- STDIO Process Output ---\n${stderrOutput}`,
+        );
+        enhancedError.name = error.name;
+        logger.error('callTool failed with STDIO logs:', {
+          message: error.message,
+          stderrLogs: error.stderrLogs,
+        });
+        throw enhancedError;
+      }
       logger.error('callTool failed:', error);
       throw error;
     } finally {
-      await client.disconnect();
+      if (client) {
+        await client.disconnect();
+      }
     }
   }
 
@@ -361,8 +395,9 @@ export default class McpCtr extends ControllerModule {
   }
 
   private async checkSystemDependency(dependency: any) {
+    const checkCommand = dependency.checkCommand || `${dependency.name} --version`;
+
     try {
-      const checkCommand = dependency.checkCommand || `${dependency.name} --version`;
       const { stdout, stderr } = await execPromise(checkCommand);
 
       if (stderr && !stdout) {
@@ -444,22 +479,19 @@ export default class McpCtr extends ControllerModule {
       const packageName = details?.packageName;
       if (!packageName) return { installed: false };
 
+      // Only check global npm list - do NOT use npx as it may download packages
       try {
         const { stdout } = await execPromise(`npm list -g ${packageName} --depth=0`);
-        if (!stdout.includes('(empty)') && stdout.includes(packageName)) return { installed: true };
+        if (!stdout.includes('(empty)') && stdout.includes(packageName)) {
+          return { installed: true };
+        }
       } catch {
-        // ignore
+        // ignore - package not found in global list
       }
 
-      try {
-        await execPromise(`npx -y ${packageName} --version`);
-        return { installed: true };
-      } catch (error) {
-        return {
-          error: error instanceof Error ? error.message : 'Unknown error',
-          installed: false,
-        };
-      }
+      // For npm packages, we don't require pre-installation
+      // npx will handle downloading and running on-demand during actual MCP connection
+      return { installed: false };
     }
 
     if (installationMethod === 'python') {
@@ -553,7 +585,7 @@ export default class McpCtr extends ControllerModule {
       const bestResult = recommendedResult || firstInstallableResult || results[0];
 
       const checkResult: CheckMcpInstallResult = {
-        ...(bestResult || {}),
+        ...bestResult,
         allOptions: results as any,
         platform: process.platform,
         success: true,

package/apps/desktop/src/main/libs/mcp/client.ts

@@ -6,15 +6,31 @@ import {
 import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
 import type { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';
 import type { Progress } from '@modelcontextprotocol/sdk/types.js';
+import type { Readable } from 'node:stream';
 
 import { getDesktopEnv } from '@/env';
 
 import type { MCPClientParams, McpPrompt, McpResource, McpTool, ToolCallResult } from './types';
 
+/**
+ * Custom error class for MCP connection errors that includes STDIO logs
+ */
+export class MCPConnectionError extends Error {
+  readonly stderrLogs: string[];
+
+  constructor(message: string, stderrLogs: string[] = []) {
+    super(message);
+    this.name = 'MCPConnectionError';
+    this.stderrLogs = stderrLogs;
+  }
+}
+
 export class MCPClient {
   private readonly mcp: Client;
 
   private transport: Transport;
+  private stderrLogs: string[] = [];
+  private isStdio: boolean = false;
 
   constructor(params: MCPClientParams) {
     this.mcp = new Client({ name: 'lobehub-desktop-mcp-client', version: '1.0.0' });
@@ -40,14 +56,21 @@ export class MCPClient {
       }
 
       case 'stdio': {
-        this.transport = new StdioClientTransport({
+        this.isStdio = true;
+        const stdioTransport = new StdioClientTransport({
           args: params.args,
           command: params.command,
           env: {
             ...getDefaultEnvironment(),
             ...params.env,
           },
+          stderr: 'pipe', // Capture stderr for better error messages
         });
+
+        // Listen to stderr stream to collect logs
+        this.setupStderrListener(stdioTransport);
+
+        this.transport = stdioTransport;
         break;
       }
 
@@ -60,16 +83,45 @@ export class MCPClient {
     }
   }
 
+  private setupStderrListener(transport: StdioClientTransport) {
+    const stderr = transport.stderr as Readable | null;
+    if (stderr) {
+      stderr.on('data', (chunk: Buffer) => {
+        const text = chunk.toString('utf8');
+        // Split by newlines and filter empty lines
+        const lines = text.split('\n').filter((line) => line.trim());
+        this.stderrLogs.push(...lines);
+      });
+    }
+  }
+
+  /**
+   * Get collected stderr logs from the STDIO process
+   */
+  getStderrLogs(): string[] {
+    return this.stderrLogs;
+  }
+
   private isMethodNotFoundError(error: unknown) {
     const err = error as any;
     if (!err) return false;
+    // eslint-disable-next-line unicorn/numeric-separators-style
     if (err.code === -32601) return true;
     if (typeof err.message === 'string' && err.message.includes('Method not found')) return true;
     return false;
   }
 
   async initialize(options: { onProgress?: (progress: Progress) => void } = {}) {
-    await this.mcp.connect(this.transport, { onprogress: options.onProgress });
+    try {
+      await this.mcp.connect(this.transport, { onprogress: options.onProgress });
+    } catch (error) {
+      // If this is a STDIO connection and we have stderr logs, enhance the error
+      if (this.isStdio && this.stderrLogs.length > 0) {
+        const originalMessage = error instanceof Error ? error.message : String(error);
+        throw new MCPConnectionError(originalMessage, this.stderrLogs);
+      }
+      throw error;
+    }
   }
 
   async disconnect() {

package/changelog/v1.json

@@ -1,4 +1,9 @@
 [
+  {
+    "children": {},
+    "date": "2026-01-15",
+    "version": "2.0.0-next.294"
+  },
   {
     "children": {},
     "date": "2026-01-15",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lobehub/lobehub",
-  "version": "2.0.0-next.293",
+  "version": "2.0.0-next.294",
   "description": "LobeHub - an open-source,comprehensive AI Agent 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/src/app/[variants]/(main)/agent/_layout/AgentIdSync.tsx

@@ -1,4 +1,5 @@
-import { useUnmount } from 'ahooks';
+import { usePrevious, useUnmount } from 'ahooks';
+import { useEffect } from 'react';
 import { useParams } from 'react-router-dom';
 import { createStoreUpdater } from 'zustand-utils';
 
@@ -9,10 +10,20 @@ const AgentIdSync = () => {
   const useStoreUpdater = createStoreUpdater(useAgentStore);
   const useChatStoreUpdater = createStoreUpdater(useChatStore);
   const params = useParams<{ aid?: string }>();
+  const prevAgentId = usePrevious(params.aid);
 
   useStoreUpdater('activeAgentId', params.aid);
   useChatStoreUpdater('activeAgentId', params.aid ?? '');
 
+  // Reset activeTopicId when switching to a different agent
+  // This prevents messages from being saved to the wrong topic bucket
+  useEffect(() => {
+    // Only reset topic when switching between agents (not on initial mount)
+    if (prevAgentId !== undefined && prevAgentId !== params.aid) {
+      useChatStore.getState().switchTopic(null, { skipRefreshMessage: true });
+    }
+  }, [params.aid, prevAgentId]);
+
   // Clear activeAgentId when unmounting (leaving chat page)
   useUnmount(() => {
     useAgentStore.setState({ activeAgentId: undefined });

package/src/app/[variants]/(main)/group/_layout/GroupIdSync.tsx

@@ -1,4 +1,5 @@
-import { useUnmount } from 'ahooks';
+import { usePrevious, useUnmount } from 'ahooks';
+import { useEffect } from 'react';
 import { useParams } from 'react-router-dom';
 import { createStoreUpdater } from 'zustand-utils';
 
@@ -10,6 +11,7 @@ const GroupIdSync = () => {
   const useAgentGroupStoreUpdater = createStoreUpdater(useAgentGroupStore);
   const useChatStoreUpdater = createStoreUpdater(useChatStore);
   const params = useParams<{ gid?: string }>();
+  const prevGroupId = usePrevious(params.gid);
   const router = useQueryRoute();
 
   // Sync groupId to agentGroupStore and chatStore
@@ -19,6 +21,15 @@ const GroupIdSync = () => {
   // Inject router to agentGroupStore for navigation
   useAgentGroupStoreUpdater('router', router);
 
+  // Reset activeTopicId when switching to a different group
+  // This prevents messages from being saved to the wrong topic bucket
+  useEffect(() => {
+    // Only reset topic when switching between groups (not on initial mount)
+    if (prevGroupId !== undefined && prevGroupId !== params.gid) {
+      useChatStore.getState().switchTopic(null, { skipRefreshMessage: true });
+    }
+  }, [params.gid, prevGroupId]);
+
   // Clear activeGroupId when unmounting (leaving group page)
   useUnmount(() => {
     useAgentGroupStore.setState({ activeGroupId: undefined, router: undefined });

package/src/features/MCP/MCPInstallProgress/InstallError/ErrorDetails.tsx

@@ -1,8 +1,7 @@
-import { Button, Flexbox, Highlighter, Icon, Tag } from '@lobehub/ui';
+import { Flexbox, Highlighter, Tag } from '@lobehub/ui';
 import { cssVar } from 'antd-style';
-import { ChevronDown, ChevronRight } from 'lucide-react';
 import * as motion from 'motion/react-m';
-import { memo, useState } from 'react';
+import { memo } from 'react';
 import { useTranslation } from 'react-i18next';
 
 import { type MCPErrorInfoMetadata } from '@/types/plugins';
@@ -12,94 +11,73 @@ const ErrorDetails = memo<{
   errorMessage?: string;
 }>(({ errorInfo, errorMessage }) => {
   const { t } = useTranslation('plugin');
-  const [expanded, setExpanded] = useState(false);
 
   return (
     <Flexbox gap={8}>
-      <Button
-        color={'default'}
-        icon={<Icon icon={expanded ? ChevronDown : ChevronRight} />}
-        onClick={() => setExpanded(!expanded)}
-        size="small"
-        style={{
-          fontSize: '12px',
-          padding: '0 4px',
-        }}
-        variant="filled"
+      <motion.div
+        animate={{ height: 'auto', opacity: 1 }}
+        initial={{ height: 0, opacity: 0 }}
+        style={{ overflow: 'hidden' }}
       >
-        {expanded
-          ? t('mcpInstall.errorDetails.hideDetails')
-          : t('mcpInstall.errorDetails.showDetails')}
-      </Button>
-
-      {expanded && (
-        <motion.div
-          animate={{ height: 'auto', opacity: 1 }}
-          initial={{ height: 0, opacity: 0 }}
-          style={{ overflow: 'hidden' }}
+        <Flexbox
+          gap={8}
+          style={{
+            backgroundColor: cssVar.colorFillQuaternary,
+            borderRadius: 8,
+            fontFamily: 'monospace',
+            fontSize: '11px',
+            padding: '8px 12px',
+          }}
         >
-          <Flexbox
-            gap={8}
-            style={{
-              backgroundColor: cssVar.colorFillQuaternary,
-              borderRadius: 8,
-              fontFamily: 'monospace',
-              fontSize: '11px',
-              padding: '8px 12px',
-            }}
-          >
-            {errorInfo.params && (
-              <Flexbox gap={4}>
-                <div>
-                  <Tag color="blue" variant={'filled'}>
-                    {t('mcpInstall.errorDetails.connectionParams')}
-                  </Tag>
-                </div>
-                <div style={{ marginTop: 4, wordBreak: 'break-all' }}>
-                  {errorInfo.params.command && (
-                    <div>
-                      {t('mcpInstall.errorDetails.command')}: {errorInfo.params.command}
-                    </div>
-                  )}
-                  {errorInfo.params.args && (
-                    <div>
-                      {t('mcpInstall.errorDetails.args')}: {errorInfo.params.args.join(' ')}
-                    </div>
-                  )}
-                </div>
-              </Flexbox>
-            )}
-
-            {errorInfo.errorLog && (
-              <Flexbox gap={4}>
-                <div>
-                  <Tag color="red" variant={'filled'}>
-                    {t('mcpInstall.errorDetails.errorOutput')}
-                  </Tag>
-                </div>
-                <Highlighter
-                  language={'log'}
-                  style={{
-                    maxHeight: 200,
-                    overflow: 'auto',
-                  }}
-                >
-                  {errorInfo.errorLog}
-                </Highlighter>
-              </Flexbox>
-            )}
+          {errorInfo.params && (
+            <Flexbox gap={4}>
+              <div>
+                <Tag color="blue" variant={'filled'}>
+                  {t('mcpInstall.errorDetails.connectionParams')}
+                </Tag>
+              </div>
+              <div style={{ marginTop: 4, wordBreak: 'break-all' }}>
+                {errorInfo.params.command && (
+                  <div>
+                    {t('mcpInstall.errorDetails.command')}: {errorInfo.params.command}
+                  </div>
+                )}
+                {errorInfo.params.args && (
+                  <div>
+                    {t('mcpInstall.errorDetails.args')}: {errorInfo.params.args.join(' ')}
+                  </div>
+                )}
+              </div>
+            </Flexbox>
+          )}
 
-            {errorInfo.originalError && errorInfo.originalError !== errorMessage && (
+          {errorInfo.errorLog && (
+            <Flexbox gap={4}>
               <div>
-                <Tag color="orange">{t('mcpInstall.errorDetails.originalError')}</Tag>
-                <div style={{ marginTop: 4, wordBreak: 'break-all' }}>
-                  {errorInfo.originalError}
-                </div>
+                <Tag color="red" variant={'filled'}>
+                  {t('mcpInstall.errorDetails.errorOutput')}
+                </Tag>
               </div>
-            )}
-          </Flexbox>
-        </motion.div>
-      )}
+              <Highlighter
+                language={'log'}
+                style={{
+                  maxHeight: 200,
+                  overflow: 'auto',
+                }}
+              >
+                {errorInfo.errorLog}
+              </Highlighter>
+            </Flexbox>
+          )}
+
+          {errorInfo.originalError && errorInfo.originalError !== errorMessage && (
+            <div>
+              <Tag color="orange">{t('mcpInstall.errorDetails.originalError')}</Tag>
+              <div style={{ marginTop: 4, wordBreak: 'break-all' }}>{errorInfo.originalError}</div>
+            </div>
+          )}
+        </Flexbox>
+      </motion.div>
     </Flexbox>
   );
 });

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

@@ -6,8 +6,10 @@ import { useTranslation } from 'react-i18next';
 
 import KeyValueEditor from '@/components/KeyValueEditor';
 import MCPStdioCommandInput from '@/components/MCPStdioCommandInput';
+import ErrorDetails from '@/features/MCP/MCPInstallProgress/InstallError/ErrorDetails';
 import { useToolStore } from '@/store/tool';
 import { mcpStoreSelectors, pluginSelectors } from '@/store/tool/selectors';
+import { type MCPErrorInfoMetadata } from '@/types/plugins';
 
 import ArgsInput from './ArgsInput';
 import CollapsibleSection from './CollapsibleSection';
@@ -46,10 +48,12 @@ const MCPManifestForm = ({ form, isEditMode }: MCPManifestFormProps) => {
   const testState = useToolStore(mcpStoreSelectors.getMCPConnectionTestState(identifier), isEqual);
 
   const [connectionError, setConnectionError] = useState<string | null>(null);
+  const [errorMetadata, setErrorMetadata] = useState<MCPErrorInfoMetadata | null>(null);
 
   const handleTestConnection = async () => {
     setIsTesting(true);
     setConnectionError(null);
+    setErrorMetadata(null);
 
     // Manually trigger validation for fields needed for the test
     let isValid = false;
@@ -97,12 +101,29 @@ const MCPManifestForm = ({ form, isEditMode }: MCPManifestFormProps) => {
         // Be careful about overwriting user input if not desired
         form.setFieldsValue({ manifest: result.manifest });
         setConnectionError(null); // 清除本地错误状态
+        setErrorMetadata(null);
       } else if (result.error) {
         // Store 已经处理了错误状态，这里可以选择显示额外的用户友好提示
         const errorMessage = t('error.testConnectionFailed', {
           error: result.error,
         });
         setConnectionError(errorMessage);
+
+        // Build error metadata for detailed display
+        if (result.errorLog || mcpType === 'stdio') {
+          setErrorMetadata({
+            errorLog: result.errorLog,
+            params:
+              mcpType === 'stdio'
+                ? {
+                    args: mcp?.args,
+                    command: mcp?.command,
+                    type: 'stdio',
+                  }
+                : undefined,
+            timestamp: Date.now(),
+          });
+        }
       }
     } catch (error) {
       // Handle unexpected errors
@@ -121,7 +142,10 @@ const MCPManifestForm = ({ form, isEditMode }: MCPManifestFormProps) => {
       <QuickImportSection
         form={form}
         isEditMode={isEditMode}
-        onClearConnectionError={() => setConnectionError(null)}
+        onClearConnectionError={() => {
+          setConnectionError(null);
+          setErrorMetadata(null);
+        }}
       />
       <Form form={form} layout={'vertical'}>
         <Flexbox>
@@ -270,9 +294,12 @@ const MCPManifestForm = ({ form, isEditMode }: MCPManifestFormProps) => {
           {(connectionError || testState.error) && (
             <Alert
               closable
-              onClose={() => setConnectionError(null)}
+              extra={errorMetadata ? <ErrorDetails errorInfo={errorMetadata} /> : undefined}
+              onClose={() => {
+                setConnectionError(null);
+                setErrorMetadata(null);
+              }}
               showIcon
-              style={{ marginBottom: 16 }}
               title={connectionError || testState.error}
               type="error"
             />

package/src/libs/mcp/types.ts

@@ -240,3 +240,34 @@ export function createMCPError(
 
   return error;
 }
+
+/**
+ * STDIO Process Output separator used in enhanced error messages
+ */
+const STDIO_OUTPUT_SEPARATOR = '--- STDIO Process Output ---';
+
+/**
+ * Parse error message to extract STDIO process output logs
+ * The enhanced error format from desktop is:
+ * "Original message\n\n--- STDIO Process Output ---\nlogs..."
+ */
+export interface ParsedStdioError {
+  errorLog?: string;
+  originalMessage: string;
+}
+
+export function parseStdioErrorMessage(errorMessage: string): ParsedStdioError {
+  const separatorIndex = errorMessage.indexOf(STDIO_OUTPUT_SEPARATOR);
+
+  if (separatorIndex === -1) {
+    return { originalMessage: errorMessage };
+  }
+
+  const originalMessage = errorMessage.slice(0, separatorIndex).trim();
+  const errorLog = errorMessage.slice(separatorIndex + STDIO_OUTPUT_SEPARATOR.length).trim();
+
+  return {
+    errorLog: errorLog || undefined,
+    originalMessage: originalMessage || errorMessage,
+  };
+}

package/src/store/tool/slices/mcpStore/action.ts

@@ -9,7 +9,7 @@ import { gt, valid } from 'semver';
 import useSWR, { type SWRResponse } from 'swr';
 import { type StateCreator } from 'zustand/vanilla';
 
-import { type MCPErrorData } from '@/libs/mcp/types';
+import { type MCPErrorData, parseStdioErrorMessage } from '@/libs/mcp/types';
 import { discoverService } from '@/services/discover';
 import { mcpService } from '@/services/mcp';
 import { pluginService } from '@/services/plugin';
@@ -132,6 +132,8 @@ const buildCloudMcpManifest = (params: {
 // Test connection result type
 export interface TestMcpConnectionResult {
   error?: string;
+  /** STDIO process output logs for debugging */
+  errorLog?: string;
   manifest?: LobeChatPluginManifest;
   success: boolean;
 }
@@ -301,8 +303,6 @@ export const createMCPPluginStoreSlice: StateCreator<
         // Check if cloudEndPoint is available: web + stdio type + haveCloudEndpoint exists
         const hasCloudEndpoint = !isDesktop && stdioOption && haveCloudEndpoint;
 
-        console.log('hasCloudEndpoint', hasCloudEndpoint);
-
         let shouldUseHttpDeployment = !!httpOption && (!hasNonHttpDeployment || !isDesktop);
 
         if (hasCloudEndpoint) {
@@ -592,7 +592,7 @@ export const createMCPPluginStoreSlice: StateCreator<
         event: 'install',
         identifier: plugin.identifier,
         source: 'self',
-      })
+      });
 
       discoverService.reportMcpInstallResult({
         identifier: plugin.identifier,
@@ -653,10 +653,22 @@ export const createMCPPluginStoreSlice: StateCreator<
         };
       } else {
         // Fallback handling for normal errors
-        const errorMessage = error instanceof Error ? error.message : String(error);
+        const rawErrorMessage = error instanceof Error ? error.message : String(error);
+
+        // Parse STDIO error message to extract process output logs
+        const { originalMessage, errorLog } = parseStdioErrorMessage(rawErrorMessage);
+
         errorInfo = {
-          message: errorMessage,
+          message: originalMessage,
           metadata: {
+            errorLog,
+            params: connection
+              ? {
+                  args: connection.args,
+                  command: connection.command,
+                  type: connection.type,
+                }
+              : undefined,
             step: 'installation_error',
             timestamp: Date.now(),
           },
@@ -800,7 +812,7 @@ export const createMCPPluginStoreSlice: StateCreator<
         event: 'activate',
         identifier: identifier,
         source: 'self',
-      })
+      });
 
       return { manifest, success: true };
     } catch (error) {
@@ -809,20 +821,23 @@ export const createMCPPluginStoreSlice: StateCreator<
         return { error: 'Test cancelled', success: false };
       }
 
-      const errorMessage = error instanceof Error ? error.message : String(error);
+      const rawErrorMessage = error instanceof Error ? error.message : String(error);
+
+      // Parse STDIO error message to extract process output logs
+      const { originalMessage, errorLog } = parseStdioErrorMessage(rawErrorMessage);
 
       // Set error state
       set(
         produce((draft: MCPStoreState) => {
           draft.mcpTestLoading[identifier] = false;
-          draft.mcpTestErrors[identifier] = errorMessage;
+          draft.mcpTestErrors[identifier] = originalMessage;
           delete draft.mcpTestAbortControllers[identifier];
         }),
         false,
         n('testMcpConnection/error'),
       );
 
-      return { error: errorMessage, success: false };
+      return { error: originalMessage, errorLog, success: false };
     }
   },
 
@@ -834,7 +849,7 @@ export const createMCPPluginStoreSlice: StateCreator<
       event: 'uninstall',
       identifier: identifier,
       source: 'self',
-    })
+    });
   },
 
   updateMCPInstallProgress: (identifier, progress) => {