Enhanced ChatGPT Clone: Features Agents, MCP, Skills, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenAPI Actions, Functions, Secure Multi-User Auth, Presets, open-source for self-hosting. Active
TypeScript aianthropicartifactsawsazurechatgptchatgpt-cloneclaudeclonedeepseekgeminigooglegpt-5librechatmcpo1openairesponses-apivisionwebui
import { useState, useRef, useEffect } from 'react';
import { MCPIcon } from '@librechat/client';
import { PermissionBits, hasPermissions } from 'librechat-data-provider';
import type { MCPServerStatusIconProps } from '~/components/MCP/MCPServerStatusIcon';
import type { MCPServerDefinition } from '~/hooks';
import McpOAuthDialog from '~/components/MCP/McpOAuthDialog';
import { useMCPServerManager, useLocalize } from '~/hooks';
import { getStatusDotColor } from './MCPStatusBadge';
import CustomIcon from '~/components/ui/CustomIcon';
import MCPServerDialog from './MCPServerDialog';
import MCPCardActions from './MCPCardActions';
import { cn } from '~/utils';
interface MCPServerCardProps {
server: MCPServerDefinition;
getServerStatusIconProps: (serverName: string) => MCPServerStatusIconProps;
canCreateEditMCPs: boolean;
}
/**
* Compact card component for displaying an MCP server with status and actions.
*
* Visual design:
* - Status shown via colored dot on icon (no separate badge - avoids redundancy)
* - Action buttons clearly indicate available operations
* - Consistent with MCPServerMenuItem in chat dropdown
*/
export default function MCPServerCard({
server,
getServerStatusIconProps,
canCreateEditMCPs,
}: MCPServerCardProps) {
const localize = useLocalize();
const triggerRef = useRef<HTMLDivElement>(null);
const { initializeServer, revokeOAuthForServer, getOAuthUrl } = useMCPServerManager();
const [dialogOpen, setDialogOpen] = useState(false);
const [awaitingOAuth, setAwaitingOAuth] = useState(false);
const statusIconProps = getServerStatusIconProps(server.serverName);
const {
serverStatus,
onConfigClick,
isInitializing,
canCancel,
onCancel,
hasCustomUserVars = false,
} = statusIconProps;
const canEditThisServer = hasPermissions(server.effectivePermissions, PermissionBits.EDIT);
const displayName = server.config?.title || server.serverName;
const description = server.config?.description;
const statusDotColor = getStatusDotColor(serverStatus, isInitializing);
const canEdit = canCreateEditMCPs && canEditThisServer;
/** The shared flow URL is cleared when its initialization ends, so it can never be stale. */
const sharedOAuthUrl = getOAuthUrl(server.serverName);
useEffect(() => {
if (!isInitializing) {
setAwaitingOAuth(false);
}
}, [isInitializing]);
/**
* `autoOpenOAuth=false` surfaces the authorization URL in the OAuth dialog, whose Continue opens
* it inside the tap. A tab opened after the initialize request is blocked on iOS home-screen apps.
*/
const handleInitialize = async () => {
/** If server has custom user vars and is not already connected, show config dialog first
* This ensures users can enter credentials before initialization attempts
*/
if (hasCustomUserVars && serverStatus?.connectionState !== 'connected') {
onConfigClick({ stopPropagation: () => {}, preventDefault: () => {} } as React.MouseEvent);
return;
}
setAwaitingOAuth(false);
const response = await initializeServer(server.serverName, false);
if (response?.oauthRequired && response.oauthUrl) {
setAwaitingOAuth(true);
}
};
const handleRevoke = () => {
revokeOAuthForServer(server.serverName);
};
const handleEditClick = (e: React.MouseEvent) => {
e.stopPropagation();
e.preventDefault();
setDialogOpen(true);
};
// Determine status text for accessibility
const getStatusText = () => {
if (isInitializing) return localize('com_nav_mcp_status_initializing');
if (!serverStatus) return localize('com_nav_mcp_status_unknown');
const { connectionState, requiresOAuth } = serverStatus;
if (connectionState === 'connecting') return localize('com_nav_mcp_status_connecting');
if (serverStatus.requestScoped) return localize('com_nav_mcp_status_on_demand');
if (connectionState === 'connected') return localize('com_nav_mcp_status_connected');
if (connectionState === 'error') return localize('com_nav_mcp_status_error');
if (connectionState === 'disconnected') {
return requiresOAuth
? localize('com_nav_mcp_status_needs_auth')
: localize('com_nav_mcp_status_disconnected');
}
return localize('com_nav_mcp_status_unknown');
};
return (
<>
<div
className={cn(
'group flex items-center gap-3 rounded-lg px-3 py-2.5',
/** Flat row, not a card: the hover fill is the only affordance a list needs. */
'hover:bg-surface-active-alt bg-transparent',
)}
aria-label={`${displayName} - ${getStatusText()}`}
>
{/* Server Icon with Status Dot */}
<div className="text-text-primary relative shrink-0">
{server.config?.iconPath ? (
<CustomIcon
src={server.config.iconPath}
className="size-8 rounded-lg object-cover"
alt=""
/>
) : (
<div className="bg-surface-tertiary text-text-secondary flex size-8 items-center justify-center rounded-lg">
<MCPIcon className="size-5" aria-hidden="true" />
</div>
)}
{/* Status dot - color indicates connection state */}
<div
className={cn(
'absolute -inset-e-0.5 -bottom-0.5 size-3 rounded-full',
'border-surface-primary border-2',
statusDotColor,
(isInitializing || serverStatus?.connectionState === 'connecting') && 'animate-pulse',
)}
aria-hidden="true"
/>
</div>
{/* Server Info */}
<div className="min-w-0 flex-1">
<div className="text-text-primary truncate text-sm font-medium">{displayName}</div>
{description && <p className="text-text-secondary truncate text-xs">{description}</p>}
</div>
{/* Actions */}
<div className="shrink-0">
<MCPCardActions
serverName={server.serverName}
serverStatus={serverStatus}
isInitializing={isInitializing}
canCancel={canCancel}
hasCustomUserVars={hasCustomUserVars}
canEdit={canEdit}
editButtonRef={triggerRef}
onEditClick={handleEditClick}
onConfigClick={onConfigClick}
onInitialize={handleInitialize}
onCancel={onCancel}
onRevoke={handleRevoke}
/>
</div>
</div>
{/* Edit Dialog - separate from card */}
{canEdit && (
<MCPServerDialog
open={dialogOpen}
onOpenChange={setDialogOpen}
triggerRef={triggerRef}
server={server}
/>
)}
<McpOAuthDialog
open={awaitingOAuth && isInitializing && sharedOAuthUrl != null}
onOpenChange={(open) => {
if (!open) {
setAwaitingOAuth(false);
}
}}
serverName={server.serverName}
oauthUrl={sharedOAuthUrl ?? ''}
iconUrl={server.config?.iconPath}
/>
</>
);
}