@lobehub/lobehub 2.0.0-next.116 → 2.0.0-next.118

package/packages/model-runtime/src/core/parameterResolver.test.ts

@@ -1,10 +1,7 @@
 import { describe, expect, it } from 'vitest';
 
-import {
-  MODEL_PARAMETER_CONFLICTS,
-  createParameterResolver,
-  resolveParameters,
-} from './parameterResolver';
+import { hasTemperatureTopPConflict } from '../const/models';
+import { createParameterResolver, resolveParameters } from './parameterResolver';
 
 describe('resolveParameters', () => {
   describe('Basic functionality', () => {
@@ -247,54 +244,41 @@ describe('createParameterResolver', () => {
   });
 });
 
-describe('MODEL_PARAMETER_CONFLICTS', () => {
-  describe('ANTHROPIC_CLAUDE_4_PLUS', () => {
-    it('should contain expected Claude 4+ models', () => {
-      expect(MODEL_PARAMETER_CONFLICTS.ANTHROPIC_CLAUDE_4_PLUS.has('claude-opus-4-1')).toBe(true);
-      expect(
-        MODEL_PARAMETER_CONFLICTS.ANTHROPIC_CLAUDE_4_PLUS.has('claude-opus-4-1-20250805'),
-      ).toBe(true);
-      expect(
-        MODEL_PARAMETER_CONFLICTS.ANTHROPIC_CLAUDE_4_PLUS.has('claude-sonnet-4-5-20250929'),
-      ).toBe(true);
-    });
-
-    it('should not contain Claude 3.x models', () => {
-      expect(MODEL_PARAMETER_CONFLICTS.ANTHROPIC_CLAUDE_4_PLUS.has('claude-3-opus-20240229')).toBe(
-        false,
-      );
-      expect(
-        MODEL_PARAMETER_CONFLICTS.ANTHROPIC_CLAUDE_4_PLUS.has('claude-3.5-sonnet-20240620'),
-      ).toBe(false);
+describe('hasTemperatureTopPConflict', () => {
+  describe('Anthropic Claude 4+ models', () => {
+    it('should return true for Claude 4+ models', () => {
+      expect(hasTemperatureTopPConflict('claude-opus-4-1-20250805')).toBe(true);
+      expect(hasTemperatureTopPConflict('claude-sonnet-4-5-20250929')).toBe(true);
+      expect(hasTemperatureTopPConflict('claude-haiku-4-5-20251001')).toBe(true);
+    });
+
+    it('should return false for Claude 3.x models', () => {
+      expect(hasTemperatureTopPConflict('claude-3-opus-20240229')).toBe(false);
+      expect(hasTemperatureTopPConflict('claude-3-5-sonnet-20240620')).toBe(false);
+    });
+  });
+
+  describe('OpenRouter Claude 4+ models', () => {
+    it('should return true for OpenRouter Claude 4+ models', () => {
+      expect(hasTemperatureTopPConflict('anthropic/claude-opus-4.5')).toBe(true);
+      expect(hasTemperatureTopPConflict('anthropic/claude-sonnet-4.1')).toBe(true);
+      expect(hasTemperatureTopPConflict('anthropic/claude-4.5-opus')).toBe(true);
+    });
+
+    it('should return false for OpenRouter Claude 3.x models', () => {
+      expect(hasTemperatureTopPConflict('anthropic/claude-3.5-sonnet')).toBe(false);
+      expect(hasTemperatureTopPConflict('anthropic/claude-3.7-sonnet')).toBe(false);
     });
   });
 
-  describe('BEDROCK_CLAUDE_4_PLUS', () => {
-    it('should contain both standard and Bedrock-specific model IDs', () => {
-      expect(MODEL_PARAMETER_CONFLICTS.BEDROCK_CLAUDE_4_PLUS.has('claude-opus-4-1')).toBe(true);
-      expect(
-        MODEL_PARAMETER_CONFLICTS.BEDROCK_CLAUDE_4_PLUS.has(
-          'anthropic.claude-opus-4-1-20250805-v1:0',
-        ),
-      ).toBe(true);
-      expect(
-        MODEL_PARAMETER_CONFLICTS.BEDROCK_CLAUDE_4_PLUS.has(
-          'us.anthropic.claude-sonnet-4-5-20250929-v1:0',
-        ),
-      ).toBe(true);
-    });
-
-    it('should contain all Bedrock regional variants', () => {
-      expect(
-        MODEL_PARAMETER_CONFLICTS.BEDROCK_CLAUDE_4_PLUS.has(
-          'anthropic.claude-opus-4-20250514-v1:0',
-        ),
-      ).toBe(true);
-      expect(
-        MODEL_PARAMETER_CONFLICTS.BEDROCK_CLAUDE_4_PLUS.has(
-          'us.anthropic.claude-opus-4-20250514-v1:0',
-        ),
-      ).toBe(true);
+  describe('Bedrock Claude 4+ models', () => {
+    it('should return true for Bedrock Claude 4+ models', () => {
+      expect(hasTemperatureTopPConflict('anthropic.claude-opus-4-1-20250805-v1:0')).toBe(true);
+      expect(hasTemperatureTopPConflict('us.anthropic.claude-sonnet-4-5-20250929-v1:0')).toBe(true);
+    });
+
+    it('should return false for Bedrock Claude 3.x models', () => {
+      expect(hasTemperatureTopPConflict('anthropic.claude-3-5-sonnet-20240620-v1:0')).toBe(false);
     });
   });
 });

package/packages/model-runtime/src/core/parameterResolver.ts

@@ -239,44 +239,3 @@ export const createParameterResolver = (options: ParameterResolverOptions) => {
     return resolveParameters(config, options);
   };
 };
-
-/**
- * Common model sets that have parameter conflicts
- */
-export const MODEL_PARAMETER_CONFLICTS = {
-  /**
-   * Claude models after Opus 4.1 that don't allow both temperature and top_p
-   */
-  ANTHROPIC_CLAUDE_4_PLUS: new Set([
-    'claude-opus-4-1',
-    'claude-opus-4-1-20250805',
-    'claude-sonnet-4-5-20250929',
-    'claude-haiku-4-5-20251001',
-    'claude-opus-4-5-20251101',
-  ]),
-
-  /**
-   * Bedrock Claude 4+ models (including Bedrock-specific model IDs)
-   */
-  BEDROCK_CLAUDE_4_PLUS: new Set([
-    'claude-opus-4-1',
-    'claude-opus-4-1-20250805',
-    'claude-opus-4-20250514',
-    'claude-sonnet-4-20250514',
-    'claude-sonnet-4-5-20250929',
-    'claude-haiku-4-5-20251001',
-    // Bedrock model IDs
-    'anthropic.claude-opus-4-1-20250805-v1:0',
-    'us.anthropic.claude-opus-4-1-20250805-v1:0',
-    'anthropic.claude-opus-4-20250514-v1:0',
-    'us.anthropic.claude-opus-4-20250514-v1:0',
-    'anthropic.claude-sonnet-4-20250514-v1:0',
-    'us.anthropic.claude-sonnet-4-20250514-v1:0',
-    'anthropic.claude-sonnet-4-5-20250929-v1:0',
-    'us.anthropic.claude-sonnet-4-5-20250929-v1:0',
-    'anthropic.claude-haiku-4-5-20251001-v1:0',
-    'us.anthropic.claude-haiku-4-5-20251001-v1:0',
-    'global.anthropic.claude-opus-4-5-20251101-v1:0',
-    'anthropic.claude-opus-4-5-20251101-v1:0',
-  ]),
-};

package/packages/model-runtime/src/index.ts

@@ -1,3 +1,4 @@
+export * from './const/models';
 export * from './core/BaseAI';
 export { pruneReasoningPayload } from './core/contextBuilders/openai';
 export { ModelRuntime } from './core/ModelRuntime';

package/packages/model-runtime/src/providers/anthropic/index.ts

@@ -1,9 +1,14 @@
 import Anthropic, { ClientOptions } from '@anthropic-ai/sdk';
 import { ModelProvider } from 'model-bank';
 
+import { hasTemperatureTopPConflict } from '../../const/models';
 import { LobeRuntimeAI } from '../../core/BaseAI';
-import { buildAnthropicMessages, buildAnthropicTools } from '../../core/contextBuilders/anthropic';
-import { MODEL_PARAMETER_CONFLICTS, resolveParameters } from '../../core/parameterResolver';
+import {
+  buildAnthropicMessages,
+  buildAnthropicTools,
+  buildSearchTool,
+} from '../../core/contextBuilders/anthropic';
+import { resolveParameters } from '../../core/parameterResolver';
 import { AnthropicStream } from '../../core/streams';
 import {
   type ChatCompletionErrorPayload,
@@ -22,6 +27,7 @@ import { StreamingResponse } from '../../utils/response';
 import { createAnthropicGenerateObject } from './generateObject';
 import { handleAnthropicError } from './handleAnthropicError';
 import { resolveCacheTTL } from './resolveCacheTTL';
+import { resolveMaxTokens } from './resolveMaxTokens';
 
 export interface AnthropicModelCard {
   created_at: string;
@@ -31,8 +37,6 @@ export interface AnthropicModelCard {
 
 type anthropicTools = Anthropic.Tool | Anthropic.WebSearchTool20250305;
 
-const modelsWithSmallContextWindow = new Set(['claude-3-opus-20240229', 'claude-3-haiku-20240307']);
-
 const DEFAULT_BASE_URL = 'https://api.anthropic.com';
 
 interface AnthropicAIParams extends ClientOptions {
@@ -140,15 +144,13 @@ export class LobeAnthropicAI implements LobeRuntimeAI {
     } = payload;
 
     const { anthropic: anthropicModels } = await import('model-bank');
-    const modelConfig = anthropicModels.find((m) => m.id === model);
-    const defaultMaxOutput = modelConfig?.maxOutput;
 
-    // 配置优先级：用户设置 > 模型配置 > 硬编码默认值
-    const getMaxTokens = () => {
-      if (max_tokens) return max_tokens;
-      if (defaultMaxOutput) return defaultMaxOutput;
-      return undefined;
-    };
+    const resolvedMaxTokens = await resolveMaxTokens({
+      max_tokens,
+      model,
+      providerModels: anthropicModels,
+      thinking,
+    });
 
     const system_message = messages.find((m) => m.role === 'system');
     const user_messages = messages.filter((m) => m.role !== 'system');
@@ -170,20 +172,8 @@ export class LobeAnthropicAI implements LobeRuntimeAI {
     });
 
     if (enabledSearch) {
-      // Limit the number of searches per request
-      const maxUses = process.env.ANTHROPIC_MAX_USES;
-
-      const webSearchTool: Anthropic.WebSearchTool20250305 = {
-        name: 'web_search',
-        type: 'web_search_20250305',
-        ...(maxUses &&
-          Number.isInteger(Number(maxUses)) &&
-          Number(maxUses) > 0 && {
-            max_uses: Number(maxUses),
-          }),
-      };
-
-      // 如果已有工具，则添加到现有工具列表中；否则创建新的工具列表
+      const webSearchTool = buildSearchTool();
+
       if (postTools && postTools.length > 0) {
         postTools = [...postTools, webSearchTool];
       } else {
@@ -192,19 +182,17 @@ export class LobeAnthropicAI implements LobeRuntimeAI {
     }
 
     if (!!thinking && thinking.type === 'enabled') {
-      const maxTokens = getMaxTokens() || 32_000; // Claude Opus 4 has minimum maxOutput
-
       // `temperature` may only be set to 1 when thinking is enabled.
       // `top_p` must be unset when thinking is enabled.
       return {
-        max_tokens: maxTokens,
+        max_tokens: resolvedMaxTokens,
         messages: postMessages,
         model,
         system: systemPrompts,
         thinking: {
           ...thinking,
           budget_tokens: thinking?.budget_tokens
-            ? Math.min(thinking.budget_tokens, maxTokens - 1) // `max_tokens` must be greater than `thinking.budget_tokens`.
+            ? Math.min(thinking.budget_tokens, resolvedMaxTokens - 1) // `max_tokens` must be greater than `thinking.budget_tokens`.
             : 1024,
         },
         tools: postTools,
@@ -212,7 +200,7 @@ export class LobeAnthropicAI implements LobeRuntimeAI {
     }
 
     // Resolve temperature and top_p parameters based on model constraints
-    const hasConflict = MODEL_PARAMETER_CONFLICTS.ANTHROPIC_CLAUDE_4_PLUS.has(model);
+    const hasConflict = hasTemperatureTopPConflict(model);
     const resolvedParams = resolveParameters(
       { temperature, top_p },
       { hasConflict, normalizeTemperature: true, preferTemperature: true },
@@ -221,7 +209,7 @@ export class LobeAnthropicAI implements LobeRuntimeAI {
     return {
       // claude 3 series model hax max output token of 4096, 3.x series has 8192
       // https://docs.anthropic.com/en/docs/about-claude/models/all-models#:~:text=200K-,Max%20output,-Normal%3A
-      max_tokens: getMaxTokens() || (modelsWithSmallContextWindow.has(model) ? 4096 : 8192),
+      max_tokens: resolvedMaxTokens,
       messages: postMessages,
       model,
       system: systemPrompts,

package/packages/model-runtime/src/providers/anthropic/resolveMaxTokens.ts

@@ -0,0 +1,35 @@
+import type { ChatStreamPayload } from '../../types';
+
+const smallContextWindowPatterns = [
+  /claude-3-opus-20240229/,
+  /claude-3-haiku-20240307/,
+  /claude-v2(:1)?$/,
+];
+
+/**
+ * Resolve the max_tokens value to align Anthropic and Bedrock behavior.
+ * Priority: user input > model-bank default maxOutput > hardcoded fallback (context-window aware).
+ */
+export const resolveMaxTokens = async ({
+  max_tokens,
+  model,
+  thinking,
+  providerModels,
+}: {
+  max_tokens?: number;
+  model: string;
+  providerModels: { id: string; maxOutput?: number }[];
+  thinking?: ChatStreamPayload['thinking'];
+}) => {
+  const defaultMaxOutput = providerModels.find((m) => m.id === model)?.maxOutput;
+
+  const preferredMaxTokens = max_tokens ?? defaultMaxOutput;
+
+  if (preferredMaxTokens) return preferredMaxTokens;
+
+  if (thinking?.type === 'enabled') return 32_000;
+
+  const hasSmallContextWindow = smallContextWindowPatterns.some((pattern) => pattern.test(model));
+
+  return hasSmallContextWindow ? 4096 : 8192;
+};

package/packages/model-runtime/src/providers/bedrock/index.test.ts

@@ -10,8 +10,6 @@ import { AgentRuntimeErrorType } from '../../types/error';
 import * as debugStreamModule from '../../utils/debugStream';
 import { LobeBedrockAI, experimental_buildLlama2Prompt } from './index';
 
-const provider = 'bedrock';
-
 // Mock the console.error to avoid polluting test output
 vi.spyOn(console, 'error').mockImplementation(() => {});
 
@@ -478,7 +476,7 @@ describe('LobeBedrockAI', () => {
             accept: 'application/json',
             body: JSON.stringify({
               anthropic_version: 'bedrock-2023-05-31',
-              max_tokens: 4096,
+              max_tokens: 8192,
               messages: [
                 {
                   content: [
@@ -521,7 +519,7 @@ describe('LobeBedrockAI', () => {
             accept: 'application/json',
             body: JSON.stringify({
               anthropic_version: 'bedrock-2023-05-31',
-              max_tokens: 4096,
+              max_tokens: 8192,
               messages: [
                 {
                   content: [
@@ -565,7 +563,7 @@ describe('LobeBedrockAI', () => {
             accept: 'application/json',
             body: JSON.stringify({
               anthropic_version: 'bedrock-2023-05-31',
-              max_tokens: 4096,
+              max_tokens: 8192,
               messages: [
                 {
                   content: [
@@ -610,7 +608,7 @@ describe('LobeBedrockAI', () => {
             accept: 'application/json',
             body: JSON.stringify({
               anthropic_version: 'bedrock-2023-05-31',
-              max_tokens: 4096,
+              max_tokens: 64_000,
               messages: [
                 {
                   content: [
@@ -654,7 +652,7 @@ describe('LobeBedrockAI', () => {
             accept: 'application/json',
             body: JSON.stringify({
               anthropic_version: 'bedrock-2023-05-31',
-              max_tokens: 4096,
+              max_tokens: 8192,
               messages: [
                 {
                   content: [

package/packages/model-runtime/src/providers/bedrock/index.ts

@@ -1,3 +1,4 @@
+import type Anthropic from '@anthropic-ai/sdk';
 import {
   BedrockRuntimeClient,
   InvokeModelCommand,
@@ -5,9 +6,10 @@ import {
 } from '@aws-sdk/client-bedrock-runtime';
 import { ModelProvider } from 'model-bank';
 
+import { hasTemperatureTopPConflict } from '../../const/models';
 import { LobeRuntimeAI } from '../../core/BaseAI';
 import { buildAnthropicMessages, buildAnthropicTools } from '../../core/contextBuilders/anthropic';
-import { MODEL_PARAMETER_CONFLICTS, resolveParameters } from '../../core/parameterResolver';
+import { resolveParameters } from '../../core/parameterResolver';
 import {
   AWSBedrockClaudeStream,
   AWSBedrockLlamaStream,
@@ -26,6 +28,7 @@ import { debugStream } from '../../utils/debugStream';
 import { getModelPricing } from '../../utils/getModelPricing';
 import { StreamingResponse } from '../../utils/response';
 import { resolveCacheTTL } from '../anthropic/resolveCacheTTL';
+import { resolveMaxTokens } from '../anthropic/resolveMaxTokens';
 
 /**
  * A prompt constructor for HuggingFace LLama 2 chat models.
@@ -62,19 +65,24 @@ export function experimental_buildLlama2Prompt(messages: { content: string; role
 export interface LobeBedrockAIParams {
   accessKeyId?: string;
   accessKeySecret?: string;
+  id?: string;
   region?: string;
   sessionToken?: string;
 }
 
 export class LobeBedrockAI implements LobeRuntimeAI {
   private client: BedrockRuntimeClient;
+  private id: string;
 
   region: string;
 
-  constructor({ region, accessKeyId, accessKeySecret, sessionToken }: LobeBedrockAIParams = {}) {
+  constructor(options: LobeBedrockAIParams = {}) {
+    const { id, region, accessKeyId, accessKeySecret, sessionToken } = options;
+
     if (!(accessKeyId && accessKeySecret))
       throw AgentRuntimeError.createError(AgentRuntimeErrorType.InvalidBedrockCredentials);
     this.region = region ?? 'us-east-1';
+    this.id = id ?? ModelProvider.Bedrock;
     this.client = new BedrockRuntimeClient({
       credentials: {
         accessKeyId: accessKeyId,
@@ -158,18 +166,28 @@ export class LobeBedrockAI implements LobeRuntimeAI {
       temperature,
       top_p,
       tools,
+      thinking,
     } = payload;
     const inputStartAt = Date.now();
     const system_message = messages.find((m) => m.role === 'system');
     const user_messages = messages.filter((m) => m.role !== 'system');
 
     // Resolve temperature and top_p parameters based on model constraints
-    const hasConflict = MODEL_PARAMETER_CONFLICTS.BEDROCK_CLAUDE_4_PLUS.has(model);
+    const hasConflict = hasTemperatureTopPConflict(model);
     const resolvedParams = resolveParameters(
       { temperature, top_p },
       { hasConflict, normalizeTemperature: true, preferTemperature: true },
     );
 
+    const { bedrock: bedrockModels } = await import('model-bank');
+
+    const resolvedMaxTokens = await resolveMaxTokens({
+      max_tokens,
+      model,
+      providerModels: bedrockModels,
+      thinking,
+    });
+
     const systemPrompts = !!system_message?.content
       ? ([
           {
@@ -177,19 +195,40 @@ export class LobeBedrockAI implements LobeRuntimeAI {
             text: system_message.content as string,
             type: 'text',
           },
-        ] as any)
+        ] as Anthropic.TextBlockParam[])
       : undefined;
 
-    const anthropicPayload = {
+    const postTools = buildAnthropicTools(tools, {
+      enabledContextCaching,
+    });
+
+    const anthropicBase = {
       anthropic_version: 'bedrock-2023-05-31',
-      max_tokens: max_tokens || 4096,
+      max_tokens: resolvedMaxTokens,
       messages: await buildAnthropicMessages(user_messages, { enabledContextCaching }),
       system: systemPrompts,
-      temperature: resolvedParams.temperature,
-      tools: buildAnthropicTools(tools, { enabledContextCaching }),
-      top_p: resolvedParams.top_p,
+      tools: postTools,
     };
 
+    const anthropicPayload =
+      thinking?.type === 'enabled'
+        ? {
+            ...anthropicBase,
+            thinking: {
+              ...thinking,
+              // `max_tokens` must be greater than `budget_tokens`
+              budget_tokens: Math.max(
+                1,
+                Math.min(thinking.budget_tokens || 1024, resolvedMaxTokens - 1),
+              ),
+            },
+          }
+        : {
+            ...anthropicBase,
+            temperature: resolvedParams.temperature,
+            top_p: resolvedParams.top_p,
+          };
+
     const command = new InvokeModelWithResponseStreamCommand({
       accept: 'application/json',
       body: JSON.stringify(anthropicPayload),
@@ -209,7 +248,7 @@ export class LobeBedrockAI implements LobeRuntimeAI {
         debugStream(debug).catch(console.error);
       }
 
-      const pricing = await getModelPricing(payload.model, ModelProvider.Bedrock);
+      const pricing = await getModelPricing(payload.model, this.id);
       const cacheTTL = resolveCacheTTL({ ...payload, enabledContextCaching }, anthropicPayload);
       const pricingOptions = cacheTTL ? { lookupParams: { ttl: cacheTTL } } : undefined;
 
@@ -218,7 +257,7 @@ export class LobeBedrockAI implements LobeRuntimeAI {
         AWSBedrockClaudeStream(prod, {
           callbacks: options?.callback,
           inputStartAt,
-          payload: { model, pricing, pricingOptions, provider: ModelProvider.Bedrock },
+          payload: { model, pricing, pricingOptions, provider: this.id },
         }),
         {
           headers: options?.headers,

package/src/app/[variants]/(main)/discover/(detail)/assistant/features/Details/Capabilities/Plugins.tsx

@@ -1,6 +1,6 @@
 import { Block } from '@lobehub/ui';
 import { Empty } from 'antd';
-import Link from 'next/link';
+import { Link } from 'react-router-dom';
 import { memo } from 'react';
 import { Flexbox } from 'react-layout-kit';
 import urlJoin from 'url-join';
@@ -20,11 +20,16 @@ const Plugin = memo(() => {
 
   return (
     <Flexbox gap={8}>
-      {config?.plugins.map((item) => (
-        <Link href={urlJoin('/discover/plugin', item)} key={item}>
-          <PluginItem identifier={item} />
-        </Link>
-      ))}
+      {config?.plugins.map((item) => {
+        const identifier =
+          typeof item === 'string' ? item : (item as { identifier: string }).identifier;
+
+        return (
+          <Link key={identifier} to={urlJoin('/discover/plugin', identifier)}>
+            <PluginItem identifier={identifier} />
+          </Link>
+        );
+      })}
     </Flexbox>
   );
 });

package/src/libs/mcp/__tests__/__snapshots__/index.test.ts.snap

@@ -5,6 +5,8 @@ exports[`MCPClient > Stdio Transport > should list tools via stdio 1`] = `
   {
     "description": "Echoes back a message with 'Hello' prefix",
     "inputSchema": {
+      "$schema": "http://json-schema.org/draft-07/schema#",
+      "additionalProperties": false,
       "properties": {
         "message": {
           "description": "The message to echo",
@@ -21,6 +23,7 @@ exports[`MCPClient > Stdio Transport > should list tools via stdio 1`] = `
   {
     "description": "Lists all available tools and methods",
     "inputSchema": {
+      "$schema": "http://json-schema.org/draft-07/schema#",
       "properties": {},
       "type": "object",
     },
@@ -29,6 +32,8 @@ exports[`MCPClient > Stdio Transport > should list tools via stdio 1`] = `
   {
     "description": "Adds two numbers",
     "inputSchema": {
+      "$schema": "http://json-schema.org/draft-07/schema#",
+      "additionalProperties": false,
       "properties": {
         "a": {
           "description": "The first number",

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

@@ -886,8 +886,48 @@ export class DiscoverService {
     const all = await this._getPluginList(locale);
     let raw = all.find((item) => item.identifier === identifier);
     if (!raw) {
-      log('getPluginDetail: plugin not found for identifier=%s', identifier);
-      return;
+      log('getPluginDetail: plugin not found in default store for identifier=%s, trying MCP plugin', identifier);
+      try {
+        const mcpDetail = await this.getMcpDetail({ identifier, locale });
+        const convertedMcp: Partial<DiscoverPluginDetail> = {
+          author:
+            typeof (mcpDetail as any).author === 'object'
+              ? (mcpDetail as any).author?.name || ''
+              : (mcpDetail as any).author || '',
+          avatar: (mcpDetail as any).icon || (mcpDetail as any).avatar || '',
+          category: (mcpDetail as any).category as any,
+          createdAt: (mcpDetail as any).createdAt || '',
+          description: mcpDetail.description || '',
+          homepage: mcpDetail.homepage || '',
+          identifier: mcpDetail.identifier,
+          manifest: undefined,
+          related: mcpDetail.related.map((item) => ({
+            author:
+              typeof (item as any).author === 'object'
+                ? (item as any).author?.name || ''
+                : (item as any).author || '',
+            avatar: (item as any).icon || (item as any).avatar || '',
+            category: (item as any).category as any,
+            createdAt: (item as any).createdAt || '',
+            description: (item as any).description || '',
+            homepage: (item as any).homepage || '',
+            identifier: item.identifier,
+            manifest: undefined,
+            schemaVersion: 1,
+            tags: (item as any).tags || [],
+            title: (item as any).name || item.identifier,
+          })) as unknown as DiscoverPluginItem[],
+          schemaVersion: 1,
+          tags: (mcpDetail as any).tags || [],
+          title: (mcpDetail as any).name || mcpDetail.identifier,
+        };
+        const plugin = merge(cloneDeep(DEFAULT_DISCOVER_PLUGIN_ITEM), convertedMcp);
+        log('getPluginDetail: returning converted MCP plugin');
+        return plugin as DiscoverPluginDetail;
+      } catch (error) {
+        log('getPluginDetail: MCP plugin not found for identifier=%s, error=%O', identifier, error);
+        return;
+      }
     }
 
     raw = merge(cloneDeep(DEFAULT_DISCOVER_PLUGIN_ITEM), raw);

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

@@ -13,9 +13,9 @@ const log = debug('lobe-mcp:content-processor');
 export type ProcessContentBlocksFn = (blocks: ToolCallContent[]) => Promise<ToolCallContent[]>;
 
 /**
- * 处理 MCP 返回的 content blocks
- * - 上传图片/音频到存储并替换 data 为代理 URL
- * - 保持其他类型的 block 不变
+ * Process content blocks returned by MCP
+ * - Upload images/audio to storage and replace data with proxy URL
+ * - Keep other types of blocks unchanged
  */
 export const processContentBlocks = async (
   blocks: ToolCallContent[],
@@ -64,10 +64,10 @@ export const processContentBlocks = async (
 };
 
 /**
- * 将 content blocks 转换为字符串
- * - text: 提取 text 字段
- * - image/audio: 提取 data 字段（通常是上传后的代理 URL）
- * - 其他: 返回空字符串
+ * Convert content blocks to string
+ * - text: Extract text field
+ * - image/audio: Extract data field (usually the proxy URL after upload)
+ * - others: Return empty string
  */
 export const contentBlocksToString = (blocks: ToolCallContent[] | null | undefined): string => {
   if (!blocks) return '';

package/src/server/services/mcp/deps/MCPSystemDepsCheckService.ts

@@ -195,13 +195,13 @@ class MCPSystemDepsCheckService {
     // Check if all system dependencies meet requirements
     const allDependenciesMet = systemDependenciesResults.every((dep) => dep.meetRequirement);
 
-    // Check if configuration is required (有必填项)
+    // Check if configuration is required (has mandatory fields)
     const configSchema = option.connection?.configSchema;
     const needsConfig = Boolean(
       configSchema &&
-        // 检查是否有 required 数组且不为空
+        // Check if there's a non-empty required array
         ((Array.isArray(configSchema.required) && configSchema.required.length > 0) ||
-          // 检查 properties 中是否有字段标记为 required
+          // Check if any field in properties is marked as required
           (configSchema.properties &&
             Object.values(configSchema.properties).some((prop: any) => prop.required === true))),
     );