@lobehub/lobehub 2.0.0-next.46 → 2.0.0-next.47

package/packages/types/src/plugins/mcp.ts

@@ -21,7 +21,7 @@ export enum MCPInstallStep {
 /* eslint-enable */
 export interface CheckMcpInstallParams {
   /**
-   * 安装详情
+   * Installation details
    */
   installationDetails: {
     packageName?: string;
@@ -29,11 +29,11 @@ export interface CheckMcpInstallParams {
     setupSteps?: string[];
   };
   /**
-   * 安装方法
+   * Installation method
    */
   installationMethod: string;
   /**
-   * 系统依赖项
+   * System dependencies
    */
   systemDependencies?: SystemDependency[];
 }
@@ -41,12 +41,12 @@ export interface CheckMcpInstallParams {
 export interface CheckMcpInstallResult {
   allDependenciesMet?: boolean;
   /**
-   * 所有部署选项的检查结果
+   * Check results for all deployment options
    */
   allOptions?: Array<{
     allDependenciesMet?: boolean;
     /**
-     * 连接信息，用于后续连接使用
+     * Connection information for subsequent connection use
      */
     connection?: {
       args?: string[];
@@ -66,11 +66,11 @@ export interface CheckMcpInstallResult {
     }>;
   }>;
   /**
-   * 配置模式，提到顶层方便访问
+   * Configuration schema, elevated to top level for easy access
    */
   configSchema?: any;
   /**
-   * 连接信息，用于后续连接使用
+   * Connection information for subsequent connection use
    */
   connection?: {
     args?: string[];
@@ -79,28 +79,28 @@ export interface CheckMcpInstallResult {
     url?: string;
   };
   /**
-   * 如果检测失败，提供错误信息
+   * Error information if detection fails
    */
   error?: string;
   /**
-   * 是否为推荐选项
+   * Whether this is the recommended option
    */
   isRecommended?: boolean;
   /**
-   * 是否需要配置（如 API key 等）
+   * Whether configuration is needed (e.g. API key, etc.)
    */
   needsConfig?: boolean;
   /**
-   * 插件安装检测结果
+   * Plugin installation detection result
    */
   packageInstalled?: boolean;
   platform: string;
   /**
-   * 检测结果是否成功
+   * Whether the detection result is successful
    */
   success: boolean;
   /**
-   * 系统依赖检测结果
+   * System dependency detection results
    */
   systemDependencies?: Array<{
     error?: string;
@@ -119,12 +119,12 @@ export interface MCPErrorInfoMetadata {
   errorLog?: string;
 
   /**
-   * 原始错误信息
+   * Original error message
    */
   originalError?: string;
 
   /**
-   * MCP 连接参数
+   * MCP connection parameters
    */
   params?: {
     args?: string[];
@@ -132,7 +132,7 @@ export interface MCPErrorInfoMetadata {
     type?: string;
   };
   /**
-   * 进程相关信息
+   * Process-related information
    */
   process?: {
     exitCode?: number;
@@ -140,31 +140,31 @@ export interface MCPErrorInfoMetadata {
   };
 
   /**
-   * 错误发生的步骤
+   * Step where the error occurred
    */
   step?: string;
 
   /**
-   * 时间戳
+   * Timestamp
    */
   timestamp?: number;
 }
 /**
- * 结构化的错误信息
+ * Structured error information
  */
 export interface MCPErrorInfo {
   /**
-   * 核心错误信息（用户友好的简短描述）
+   * Core error message (user-friendly brief description)
    */
   message: string;
 
   /**
-   * 结构化的错误元数据
+   * Structured error metadata
    */
   metadata?: MCPErrorInfoMetadata;
 
   /**
-   * 错误类型
+   * Error type
    */
   type: MCPErrorType;
 }
@@ -174,7 +174,7 @@ export interface MCPInstallProgress {
   configSchema?: any;
   // connection info from checkInstallation
   connection?: any;
-  // 结构化的错误信息，当安装失败时显示
+  // Structured error information, displayed when installation fails
   errorInfo?: MCPErrorInfo;
   manifest?: any;
   // LobeChatPluginManifest
@@ -182,12 +182,12 @@ export interface MCPInstallProgress {
   // 0-100
   progress: number;
   step: MCPInstallStep;
-  // 系统依赖检测结果，当需要安装依赖时显示
+  // System dependency detection results, displayed when dependencies need to be installed
   systemDependencies?: Array<{
     error?: string;
     installInstructions?: {
-      current?: string; // 当前系统的安装指令
-      manual?: string; // 手动安装指令
+      current?: string; // Installation command for the current system
+      manual?: string; // Manual installation command
     };
     installed: boolean;
     meetRequirement: boolean;
@@ -206,16 +206,16 @@ export interface McpConnection {
     token?: string;
     type: 'none' | 'bearer' | 'oauth2';
   };
-  // STDIO 连接参数
+  // STDIO connection parameters
   command?: string;
   env?: Record<string, string>;
   headers?: Record<string, string>;
   type: 'http' | 'stdio';
-  // HTTP 连接参数
+  // HTTP connection parameters
   url?: string;
 }
 
-// 测试连接参数类型
+// Test connection parameter type
 export interface McpConnectionParams {
   connection: McpConnection;
   identifier: string;

package/packages/types/src/plugins/protocol.ts

@@ -1,21 +1,21 @@
 /**
- * 协议来源类型
+ * Protocol source type
  */
 export enum ProtocolSource {
-  /** 社区贡献 */
+  /** Community contribution */
   COMMUNITY = 'community',
-  /** 开发者自定义 */
+  /** Developer custom */
   DEVELOPER = 'developer',
-  /** GitHub 官方 */
+  /** GitHub official */
   GITHUB_OFFICIAL = 'github_official',
-  /** 官方LobeHub市场 */
+  /** Official LobeHub marketplace */
   OFFICIAL = 'official',
-  /** 第三方市场 */
+  /** Third-party marketplace */
   THIRD_PARTY = 'third_party',
 }
 
 /**
- * MCP Schema - stdio 配置类型
+ * MCP Schema - stdio configuration type
  */
 export interface McpStdioConfig {
   args?: string[];
@@ -25,7 +25,7 @@ export interface McpStdioConfig {
 }
 
 /**
- * MCP Schema - http 配置类型
+ * MCP Schema - http configuration type
  */
 export interface McpHttpConfig {
   headers?: Record<string, string>;
@@ -34,74 +34,74 @@ export interface McpHttpConfig {
 }
 
 /**
- * MCP Schema 配置类型
+ * MCP Schema configuration type
  */
 export type McpConfig = McpStdioConfig | McpHttpConfig;
 
 /**
- * MCP Schema 对象
- * 符合 RFC 0001 定义
+ * MCP Schema object
+ * Conforms to RFC 0001 definition
  */
 export interface McpSchema {
-  /** 插件作者 */
+  /** Plugin author */
   author: string;
-  /** 插件配置 */
+  /** Plugin configuration */
   config: McpConfig;
-  /** 插件描述 */
+  /** Plugin description */
   description: string;
-  /** 插件主页 */
+  /** Plugin homepage */
   homepage?: string;
-  /** 插件图标 */
+  /** Plugin icon */
   icon?: string;
-  /** 插件唯一标识符，必须与URL中的id参数匹配 */
+  /** Plugin unique identifier, must match the id parameter in the URL */
   identifier: string;
-  /** 插件名称 */
+  /** Plugin name */
   name: string;
-  /** 插件版本 (semver) */
+  /** Plugin version (semver) */
   version: string;
 }
 
 /**
- * RFC 0001 协议参数
+ * RFC 0001 protocol parameters
  * lobehub://plugin/install?id=xxx&schema=xxx&marketId=xxx&meta_*=xxx
  */
 export interface McpInstallProtocolParamsRFC {
-  /** 可选的 UI 显示元数据，以 meta_ 为前缀 */
+  /** Optional UI display metadata, prefixed with meta_ */
   [key: `meta_${string}`]: string | undefined;
-  /** 插件的唯一标识符 */
+  /** Unique identifier of the plugin */
   id: string;
-  /** 提供该插件的 Marketplace 的唯一标识符 */
+  /** Unique identifier of the Marketplace providing this plugin */
   marketId?: string;
-  /** Base64URL 编码的 MCP Schema 对象 */
+  /** Base64URL encoded MCP Schema object */
   schema: string;
-  /** 插件类型，对于 MCP 固定为 'mcp' */
+  /** Plugin type, fixed as 'mcp' for MCP */
   type: 'mcp';
 }
 
 /**
- * 协议URL解析结果
+ * Protocol URL parsing result
  */
 export interface ProtocolUrlParsed {
-  /** 操作类型 (如: 'install') */
+  /** Action type (e.g.: 'install') */
   action: 'install' | 'configure' | 'update';
-  /** 解析后的参数 */
+  /** Parsed parameters */
   params: {
     id: string;
     marketId?: string;
     type: string;
   };
-  /** MCP Schema 对象 */
+  /** MCP Schema object */
   schema: McpSchema;
-  /** 协议来源 */
+  /** Protocol source */
   source: ProtocolSource;
-  /** 插件类型 (如: 'mcp') */
+  /** Plugin type (e.g.: 'mcp') */
   type: 'mcp' | 'plugin';
-  /** URL类型 (如: 'plugin') */
+  /** URL type (e.g.: 'plugin') */
   urlType: string;
 }
 
 /**
- * 安装确认弹窗信息
+ * Installation confirmation dialog information
  */
 export interface InstallConfirmationInfo {
   dependencies?: string[];
@@ -125,42 +125,42 @@ export interface InstallConfirmationInfo {
       url?: string;
     };
     type: ProtocolSource;
-    verified: boolean; // 是否为验证来源
+    verified: boolean; // Whether it's a verified source
   };
 }
 
 /**
- * 协议处理器接口
+ * Protocol handler interface
  */
 export interface ProtocolHandler {
   /**
-   * 处理协议URL
+   * Handle protocol URL
    */
   handle(
     parsed: ProtocolUrlParsed,
   ): Promise<{ error?: string; success: boolean; targetWindow?: string }>;
 
   /**
-   * 支持的操作
+   * Supported actions
    */
   readonly supportedActions: string[];
 
   /**
-   * 协议类型
+   * Protocol type
    */
   readonly type: string;
 }
 
 /**
- * 协议路由配置
+ * Protocol routing configuration
  */
 export interface ProtocolRouteConfig {
-  /** 操作类型 */
+  /** Action type */
   action: string;
-  /** 目标路径（相对于窗口base路径） */
+  /** Target path (relative to window base path) */
   targetPath?: string;
-  /** 目标窗口 */
+  /** Target window */
   targetWindow: 'chat' | 'settings';
-  /** 协议类型 */
+  /** Protocol type */
   type: string;
 }

package/packages/types/src/search.ts

@@ -4,16 +4,16 @@ export type SearchMode = 'off' | 'auto' | 'on';
 
 export enum ModelSearchImplement {
   /**
-   * 模型内置了搜索功能
-   * 类似 Jina 、PPLX 等模型的搜索模式，让调用方无感知
+   * Model has built-in search functionality
+   * Similar to search modes of models like Jina, PPLX, transparent to the caller
    */
   Internal = 'internal',
   /**
-   * 使用参数开关的方式，例如 Qwen、Google、OpenRouter，搜索结果在
+   * Uses parameter toggle approach, e.g. Qwen, Google, OpenRouter, search results in
    */
   Params = 'params',
   /**
-   * 使用工具调用的方式
+   * Uses tool calling approach
    */
   Tool = 'tool',
 }

package/packages/types/src/tool/plugin.ts

@@ -19,7 +19,7 @@ export interface CustomPluginParams {
 
   /* eslint-disable sort-keys-fix/sort-keys-fix , typescript-sort-keys/interface */
   /**
-   * TODO: 临时方案，后续需要做一次大重构
+   * TODO: Temporary solution, needs major refactoring in the future
    */
   mcp?: {
     args?: string[];
@@ -27,13 +27,13 @@ export interface CustomPluginParams {
     command?: string;
     type: 'http' | 'stdio';
     url?: string;
-    // 新增认证配置支持
+    // Added authentication configuration support
     auth?: {
       type: 'none' | 'bearer' | 'oauth2';
       token?: string; // Bearer Token
       accessToken?: string; // OAuth2 Access Token
     };
-    // 新增 headers 配置支持
+    // Added headers configuration support
     headers?: Record<string, string>;
   };
   avatar?: string;

package/src/app/(backend)/f/[id]/route.ts

@@ -0,0 +1,55 @@
+import debug from 'debug';
+
+import { FileModel } from '@/database/models/file';
+import { getServerDB } from '@/database/server';
+import { FileService } from '@/server/services/file';
+
+const log = debug('lobe-file:proxy');
+
+type Params = Promise<{ id: string }>;
+
+/**
+ * File proxy service
+ * GET /f/:id
+ *
+ * Features:
+ * - Query database to get file record (without userId filter for public access)
+ * - Generate access URL based on platform (desktop → local file, web → S3 presigned URL)
+ * - Return 302 redirect
+ */
+export const GET = async (_req: Request, segmentData: { params: Params }) => {
+  try {
+    const params = await segmentData.params;
+    const { id } = params;
+
+    log('File proxy request: %s', id);
+
+    // Get database connection
+    const db = await getServerDB();
+
+    // Query file record without userId filter (public access)
+    const file = await FileModel.getFileById(db, id);
+
+    if (!file) {
+      log('File not found: %s', id);
+      return new Response('File not found', {
+        status: 404,
+      });
+    }
+
+    // Create file service with file owner's userId
+    const fileService = new FileService(db, file.userId);
+
+    // Web: Generate S3 presigned URL (5 minutes expiry)
+    const redirectUrl = await fileService.createPreSignedUrlForPreview(file.url, 300);
+    log('Web S3 presigned URL generated (expires in 5 min)');
+
+    // Return 302 redirect
+    return Response.redirect(redirectUrl, 302);
+  } catch (error) {
+    console.error('File proxy error:', error);
+    return new Response('Internal server error', {
+      status: 500,
+    });
+  }
+};

package/src/envs/app.ts

@@ -18,7 +18,9 @@ const APP_URL = process.env.APP_URL
   ? process.env.APP_URL
   : isInVercel
     ? vercelUrl
-    : 'http://localhost:3010';
+    : process.env.NODE_ENV === 'development'
+      ? 'http://localhost:3010'
+      : 'http://localhost:3210';
 
 // INTERNAL_APP_URL is used for server-to-server calls to bypass CDN/proxy
 // Falls back to APP_URL if not set
@@ -37,7 +39,6 @@ export const getAppConfig = () => {
     },
     server: {
       ACCESS_CODES: z.any(z.string()).optional(),
-
       AGENTS_INDEX_URL: z.string().url(),
 
       DEFAULT_AGENT_CONFIG: z.string(),
@@ -46,7 +47,7 @@ export const getAppConfig = () => {
       PLUGINS_INDEX_URL: z.string().url(),
       PLUGIN_SETTINGS: z.string().optional(),
 
-      APP_URL: z.string().optional(),
+      APP_URL: z.string(),
       INTERNAL_APP_URL: z.string().optional(),
       VERCEL_EDGE_CONFIG: z.string().optional(),
       MIDDLEWARE_REWRITE_THROUGH_LOCAL: z.boolean().optional(),

package/src/features/Conversation/components/VirtualizedList/index.tsx

@@ -1,5 +1,6 @@
 'use client';
 
+import isEqual from 'fast-deep-equal';
 import {
   ReactNode,
   forwardRef,
@@ -132,6 +133,6 @@ const VirtualizedList = memo<VirtualizedListProps>(({ mobile, dataSource, itemCo
       </WideScreenContainer>
     </VirtuosoContext>
   );
-});
+}, isEqual);
 
 export default VirtualizedList;

package/src/features/PluginsUI/Render/MCPType/index.tsx

@@ -1,4 +1,4 @@
-import { Markdown } from '@lobehub/ui';
+import { Image, Markdown } from '@lobehub/ui';
 import { memo } from 'react';
 import { Flexbox } from 'react-layout-kit';
 
@@ -21,14 +21,22 @@ const MCPType = memo<MCPTypeProps>(({ pluginState, arguments: args }) => {
 
   const { content } = pluginState;
 
+  const hasImage = content.some((item) => item.type === 'image');
   return (
-    <Flexbox gap={8} style={{ maxHeight: 400, overflow: 'scroll', padding: 8, width: '100%' }}>
-      <div>
-        <Arguments arguments={args} />
-      </div>
+    <Flexbox
+      gap={8}
+      style={
+        !hasImage ? { maxHeight: 400, overflow: 'scroll', padding: 8, width: '100%' } : undefined
+      }
+    >
+      {args && (
+        <div>
+          <Arguments arguments={args} />
+        </div>
+      )}
       <Flexbox>
         <Flexbox>
-          {content.map((item) => {
+          {content.map((item, index) => {
             switch (item.type) {
               case 'text': {
                 return (
@@ -38,6 +46,18 @@ const MCPType = memo<MCPTypeProps>(({ pluginState, arguments: args }) => {
                 );
               }
 
+              case 'image': {
+                return (
+                  <Image
+                    alt="MCP content"
+                    height={'auto'}
+                    key={`image-${index}`}
+                    src={item.data}
+                    width={'100%'}
+                  />
+                );
+              }
+
               default: {
                 return null;
               }

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

@@ -2,8 +2,12 @@ import { GetStreamableMcpServerManifestInputSchema } from '@lobechat/types';
 import debug from 'debug';
 import { z } from 'zod';
 
+import { ToolCallContent } from '@/libs/mcp';
 import { authedProcedure, router } from '@/libs/trpc/lambda';
+import { serverDatabase } from '@/libs/trpc/lambda/middleware';
+import { FileService } from '@/server/services/file';
 import { mcpService } from '@/server/services/mcp';
+import { processContentBlocks } from '@/server/services/mcp/contentProcessor';
 
 const log = debug('lobe-mcp:router');
 
@@ -22,7 +26,13 @@ const stdioParamsSchema = z.object({
   type: z.literal('stdio').default('stdio'),
 });
 
-const mcpProcedure = authedProcedure;
+const mcpProcedure = authedProcedure.use(serverDatabase).use(async ({ ctx, next }) => {
+  return next({
+    ctx: {
+      fileService: new FileService(ctx.serverDB, ctx.userId),
+    },
+  });
+});
 
 export const mcpRouter = router({
   getStdioMcpServerManifest: mcpProcedure.input(stdioParamsSchema).query(async ({ input }) => {
@@ -85,13 +95,18 @@ export const mcpRouter = router({
         toolName: z.string(),
       }),
     )
-    .mutation(async ({ input }) => {
-      // Pass the validated params, toolName, and args to the service
-      return await mcpService.callTool(
-        { ...input.params, env: input.env },
-        input.toolName,
-        input.args,
-      );
+    .mutation(async ({ input, ctx }) => {
+      // Create a closure that binds fileService and userId to processContentBlocks
+      const boundProcessContentBlocks = async (blocks: ToolCallContent[]) =>
+        processContentBlocks(blocks, ctx.fileService);
+
+      // Pass the validated params, toolName, args, and bound processContentBlocks to the service
+      return await mcpService.callTool({
+        clientParams: { ...input.params, env: input.env },
+        toolName: input.toolName,
+        argsStr: input.args,
+        processContentBlocks: boundProcessContentBlocks,
+      });
     }),
 
   validMcpServerInstallable: mcpProcedure