feat: code by huntun

web/src/app/infra/entities/api/index.ts

@@ -308,3 +308,66 @@ export interface RetrieveResult {
 export interface ApiRespKnowledgeBaseRetrieve {
   results: RetrieveResult[];
 }
+
+// MCP
+export interface ApiRespMCPServers {
+  servers: MCPServer[];
+}
+
+export interface ApiRespMCPServer {
+  server: MCPServer;
+}
+
+export interface MCPServer {
+  name: string;
+  mode: 'stdio' | 'sse';
+  enable: boolean;
+  config: MCPServerConfig;
+  status: 'connected' | 'disconnected' | 'error';
+  tools: MCPTool[];
+  error?: string;
+}
+
+export interface MCPServerConfig {
+  name: string;
+  mode: 'stdio' | 'sse';
+  enable: boolean;
+  // stdio mode
+  command?: string;
+  args?: string[];
+  env?: Record<string, string>;
+  // sse mode
+  url?: string;
+  headers?: Record<string, string>;
+  timeout?: number;
+}
+
+export interface MCPTool {
+  name: string;
+  description: string;
+  parameters: object;
+}
+
+// MCP Market
+export interface MCPMarketResponse {
+  servers: MCPMarketServer[];
+  total: number;
+}
+
+export interface MCPMarketServer {
+  ID: number;
+  CreatedAt: string; // ISO 8601 格式日期
+  UpdatedAt: string;
+  DeletedAt: string | null;
+  name: string;
+  author: string;
+  description: string;
+  repository: string; // GitHub 仓库路径
+  artifacts_path: string;
+  stars: number;
+  downloads: number;
+  status: 'initialized' | 'mounted';
+  synced_at: string;
+  pushed_at: string; // 最后一次代码推送时间
+  version?: string;
+}

web/src/app/infra/http/BackendClient.ts

@@ -33,6 +33,9 @@ import {
   ApiRespProviderEmbeddingModel,
   EmbeddingModel,
   ApiRespPluginSystemStatus,
+  ApiRespMCPServers,
+  ApiRespMCPServer,
+  MCPServerConfig,
 } from '@/app/infra/entities/api';
 import { GetBotLogsRequest } from '@/app/infra/http/requestParam/bots/GetBotLogsRequest';
 import { GetBotLogsResponse } from '@/app/infra/http/requestParam/bots/GetBotLogsResponse';
@@ -488,6 +491,67 @@ export class BackendClient extends BaseHttpClient {
     return this.post(`/api/v1/plugins/${author}/${name}/upgrade`);
   }
 
+    // ============ MCP API ============
+    public getMCPServers(): Promise<ApiRespMCPServers> {
+      return this.get('/api/v1/mcp/servers');
+    }
+  
+    public getMCPServer(serverName: string): Promise<ApiRespMCPServer> {
+      return this.get(`/api/v1/mcp/servers/${serverName}`);
+    }
+  
+    public createMCPServer(
+      server: MCPServerConfig,
+    ): Promise<AsyncTaskCreatedResp> {
+      return this.post('/api/v1/mcp/servers', server);
+    }
+  
+    public updateMCPServer(
+      serverName: string,
+      server: Partial<MCPServerConfig>,
+    ): Promise<AsyncTaskCreatedResp> {
+      return this.put(`/api/v1/mcp/servers/${serverName}`, server);
+    }
+  
+    public deleteMCPServer(serverName: string): Promise<AsyncTaskCreatedResp> {
+      return this.delete(`/api/v1/mcp/servers/${serverName}`);
+    }
+  
+    public toggleMCPServer(
+      serverName: string,
+      target_enabled: boolean,
+    ): Promise<AsyncTaskCreatedResp> {
+      return this.put(`/api/v1/mcp/servers/${serverName}/toggle`, {
+        target_enabled,
+      });
+    }
+  
+    public testMCPServer(serverName: string): Promise<AsyncTaskCreatedResp> {
+      return this.post(`/api/v1/mcp/servers/${serverName}/test`);
+    }
+  
+    // public getMCPMarketServers(
+    //   page: number,
+    //   page_size: number,
+    //   query: string,
+    //   sort_by: string = 'stars',
+    //   sort_order: string = 'DESC',
+    // ): Promise<MCPMarketResponse> {
+    //   return this.post(`/api/v1/market/mcp`, {
+    //     page,
+    //     page_size,
+    //     query,
+    //     sort_by,
+    //     sort_order,
+    //   });
+    // }
+  
+    public installMCPServerFromGithub(
+      source: string,
+    ): Promise<AsyncTaskCreatedResp> {
+      return this.post('/api/v1/mcp/install/github', { source });
+    }
+
   // ============ System API ============
   public getSystemInfo(): Promise<ApiRespSystemInfo> {
     return this.get('/api/v1/system/info');