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 type { MCPServerStatus } from 'librechat-data-provider';
import type { MCPServerDefinition } from '~/hooks/MCP/useMCPServerManager';
import type { MCPServerStatusIconProps } from './MCPServerStatusIcon';
export type { MCPServerStatus };
export interface SelectedIconInfo {
key: string;
serverName: string;
iconPath: string | null;
displayName: string;
}
export type ConnectionStatusMap = Record<string, MCPServerStatus>;
/**
* Generates a list of icons to display for selected MCP servers.
* - Custom icons are shown individually
* - Multiple default icons are consolidated into one
* - Limited to maxIcons with overflow count
*/
export function getSelectedServerIcons(
selectedServers: MCPServerDefinition[],
maxIcons: number = 3,
): { icons: SelectedIconInfo[]; overflowCount: number; defaultServerNames: string[] } {
const customIcons: SelectedIconInfo[] = [];
const defaultServerNames: string[] = [];
for (const server of selectedServers) {
const displayName = server.config?.title || server.serverName;
if (server.config?.iconPath) {
customIcons.push({
key: server.serverName,
serverName: server.serverName,
iconPath: server.config.iconPath,
displayName,
});
} else {
defaultServerNames.push(server.serverName);
}
}
// Add one default icon entry if any server uses default icon
// Custom icons are prioritized first, default icon comes last
const allIcons: SelectedIconInfo[] =
defaultServerNames.length > 0
? [
...customIcons,
{
key: '_default_',
serverName: defaultServerNames[0],
iconPath: null,
displayName: 'MCP',
},
]
: customIcons;
const visibleIcons = allIcons.slice(0, maxIcons);
const overflowCount = Math.max(0, allIcons.length - maxIcons);
return { icons: visibleIcons, overflowCount, defaultServerNames };
}
/**
* Unified status color system following UX best practices:
* - Green: Connected/Active (success)
* - Blue: Connecting/In-progress or request-scoped on-demand
* - Amber: Needs user action (OAuth required, config missing)
* - Gray: Disconnected/Inactive (neutral - server is simply off)
* - Red: Error (failed, needs retry)
*
* Key insight: "Disconnected" is neutral (gray), not a warning.
* Amber is reserved for states requiring user intervention.
*/
export function getStatusColor(
serverName: string,
connectionStatus?: ConnectionStatusMap,
isInitializing?: (serverName: string) => boolean,
): string {
// In-progress states: blue
if (isInitializing?.(serverName)) {
return 'bg-status-info';
}
const status = connectionStatus?.[serverName];
if (!status) {
return 'bg-status-neutral';
}
const { connectionState, requiresOAuth, requestScoped } = status;
// Connecting: blue (in progress)
if (connectionState === 'connecting') {
return 'bg-status-info';
}
if (requestScoped) {
return 'bg-status-info';
}
// Connected: green (success)
if (connectionState === 'connected') {
return 'bg-status-success';
}
// Error: red
if (connectionState === 'error') {
return 'bg-status-error';
}
// Disconnected: check if needs action or just inactive
if (connectionState === 'disconnected') {
// Needs OAuth = amber (requires user action)
if (requiresOAuth) {
return 'bg-status-warning';
}
// Simply disconnected = gray (neutral/inactive)
return 'bg-status-neutral';
}
return 'bg-status-neutral';
}
export function getStatusTextKey(
serverName: string,
connectionStatus?: ConnectionStatusMap,
isInitializing?: (serverName: string) => boolean,
): string {
if (isInitializing?.(serverName)) {
return 'com_nav_mcp_status_initializing';
}
const status = connectionStatus?.[serverName];
if (!status) {
return 'com_nav_mcp_status_unknown';
}
const { connectionState, requiresOAuth, requestScoped } = status;
if (connectionState === 'connecting') {
return 'com_nav_mcp_status_connecting';
}
if (requestScoped) {
return 'com_nav_mcp_status_on_demand';
}
// Special case: disconnected but needs OAuth shows different text
if (connectionState === 'disconnected' && requiresOAuth) {
return 'com_nav_mcp_status_needs_auth';
}
const keyMap: Record<string, string> = {
connected: 'com_nav_mcp_status_connected',
connecting: 'com_nav_mcp_status_connecting',
disconnected: 'com_nav_mcp_status_disconnected',
error: 'com_nav_mcp_status_error',
};
return keyMap[connectionState] || 'com_nav_mcp_status_unknown';
}
/**
* Request-scoped servers are usable without an idle transport connection once
* their authorization requirement is satisfied. Agent tooling uses this
* readiness signal to attach the runtime wildcard instead of waiting for a
* tool catalog that can only be discovered during a chat request.
*/
export function isMCPServerReadyForAgent(
status: MCPServerStatus | undefined,
requestScoped: boolean,
hasCustomUserVars = false,
): boolean {
if (requestScoped && hasCustomUserVars && status?.configurationState !== 'configured') {
return false;
}
if (status?.connectionState === 'connected') {
return true;
}
if (!requestScoped) {
return false;
}
return (
status?.authorizationState === 'not_required' || status?.authorizationState === 'authorized'
);
}
/**
* Determines if an action button should be shown for a server status.
* Returns true only when the button would be actionable (not just informational).
*/
export function shouldShowActionButton(statusIconProps?: MCPServerStatusIconProps | null): boolean {
if (!statusIconProps) return false;
const { serverStatus, canCancel, hasCustomUserVars, isInitializing } = statusIconProps;
// Show cancel button during OAuth flow
if (isInitializing && canCancel) return true;
// Don't show spinner-only state (no action available)
if (isInitializing) return false;
if (!serverStatus) return false;
const { connectionState, requiresOAuth, requestScoped } = serverStatus;
// Request-scoped servers can only be initialized with an active MCP request context,
// but their per-user variables must remain configurable while idle.
if ((connectionState === 'disconnected' || connectionState === 'error') && requestScoped) {
return hasCustomUserVars === true;
}
if (connectionState === 'connected' && requestScoped) return hasCustomUserVars === true;
// Show for disconnected/error (can reconnect/configure)
if (connectionState === 'disconnected' || connectionState === 'error') return true;
// Show a cancel action for pending OAuth connections.
if (connectionState === 'connecting' && requiresOAuth && canCancel) return true;
// Don't show connecting spinner when no action is available.
if (connectionState === 'connecting') return false;
// Connected: only show if there's config to manage
if (connectionState === 'connected') return hasCustomUserVars || requiresOAuth;
return false;
}