π OpenHands: AI-Driven Development
import React from "react";
import { AxiosError } from "axios";
import {
ExtensionsNavigation,
ExtensionsCompactNavigation,
} from "#/components/features/skills/extensions-navigation";
import { useTranslation } from "react-i18next";
import { I18nKey } from "#/i18n/declaration";
import { BrandButton } from "#/components/features/settings/brand-button";
import { useSettings } from "#/hooks/query/use-settings";
import { useUpdateMcpServer } from "#/hooks/mutation/use-update-mcp-server";
import { parseMcpConfig } from "#/utils/mcp-config";
import { displayErrorToast } from "#/utils/custom-toast-handlers";
import { retrieveAxiosErrorMessage } from "#/utils/retrieve-axios-error-message";
import { settingsLikeMainScrollClassName } from "#/utils/settings-like-page-layout-classes";
import {
findCatalogEntryForServer,
getMcpMarketplaceCatalog,
installedServerMatchesQuery,
} from "#/utils/mcp-marketplace-utils";
import {
INTEGRATION_CATALOG as MCP_MARKETPLACE,
type IntegrationCatalogEntry as MarketplaceEntry,
} from "@openhands/extensions/integrations";
import { MCPServerConfig } from "#/types/mcp-server";
import { flattenMcpConfig } from "#/utils/mcp-installed-servers";
import {
InstalledServersSection,
McpToolbar,
MarketplaceSection,
InstallServerModal,
CustomServerEditor,
type McpSectionFilter,
} from "#/components/features/mcp-page";
// No ACP guard here (unlike `/settings` and `/settings/condenser`): MCP
// servers configured via `agent_settings.mcp_config` are now forwarded to
// the ACP subprocess at session creation, so this page is meaningful for
// both OpenHands and ACP agents. The same editor and MCP settings storage
// drive both kinds.
export default function MCPPage() {
const { t } = useTranslation("openhands");
const { data: settings, isLoading } = useSettings();
const { mutate: updateMcpServer } = useUpdateMcpServer();
const [installEntry, setInstallEntry] =
React.useState<MarketplaceEntry | null>(null);
const [editingServer, setEditingServer] =
React.useState<MCPServerConfig | null>(null);
const [searchQuery, setSearchQuery] = React.useState("");
const [sectionFilter, setSectionFilter] =
React.useState<McpSectionFilter>("all");
const mcpConfig =
settings?.mcp_config ??
parseMcpConfig(settings?.agent_settings?.mcp_config);
const allServers = flattenMcpConfig(mcpConfig);
const mcpMarketplace = getMcpMarketplaceCatalog(MCP_MARKETPLACE);
// Filter installed servers by the search query. We pair each server
// with its catalog entry (if any) so the search can match friendly
// names like "Slack" against a stdio server whose own `.name` is
// just "slack".
const filteredInstalledServers = allServers.filter((server) =>
installedServerMatchesQuery(
server,
findCatalogEntryForServer(server, mcpMarketplace),
searchQuery,
),
);
const handleMarketplaceInstall = (entry: MarketplaceEntry) => {
setInstallEntry(entry);
};
const handleEdit = (server: MCPServerConfig) => {
setEditingServer(server);
};
// Disabling withholds the server from the agent while leaving its entry β
// and its secrets β in `mcp_config`. `useUpdateMcpServer` is reused rather
// than given a bespoke hook because it already substitutes redacted
// credentials, without which the save would drop them.
const handleToggleEnabled = (server: MCPServerConfig, enabled: boolean) => {
updateMcpServer(
{ serverId: server.id, server: { ...server, enabled } },
{
onError: (err) => {
const message = retrieveAxiosErrorMessage(err as AxiosError);
displayErrorToast(message || t(I18nKey.ERROR$GENERIC));
},
},
);
};
if (isLoading || !settings) {
return (
<div
data-testid="mcp-page"
className="flex h-full gap-4 lg:gap-10 lg:pl-10"
>
<ExtensionsNavigation />
<div className="flex h-full flex-1 items-center justify-center px-4 lg:px-0">
<div className="h-8 w-8 rounded-full border-2 border-transparent border-t-contrast animate-spin" />
</div>
</div>
);
}
return (
<div
data-testid="mcp-page"
className="flex h-full gap-4 lg:gap-10 lg:pl-10"
>
<ExtensionsNavigation />
<main className={settingsLikeMainScrollClassName}>
<div className="mx-auto flex w-full min-w-0 max-w-200 flex-col gap-6">
<ExtensionsCompactNavigation />
<div className="min-w-0">
<div className="flex flex-wrap items-start justify-between gap-4">
<div className="min-w-0 flex-1 basis-64 space-y-1">
<h2 className="text-xl font-medium leading-6 text-foreground">
{t(I18nKey.SETTINGS$MCP_TITLE)}
</h2>
<div className="max-w-2xl text-sm text-tertiary-light">
{t(I18nKey.MCP$PAGE_DESCRIPTION)}
</div>
</div>
<BrandButton
type="button"
variant="secondary"
testId="mcp-add-custom-server"
className="flex-shrink-0 whitespace-nowrap"
onClick={() => setEditingServer({ id: "", type: "sse" })}
>
{t(I18nKey.MCP$ADD_CUSTOM)}
</BrandButton>
</div>
</div>
<McpToolbar
search={searchQuery}
onSearchChange={setSearchQuery}
sectionFilter={sectionFilter}
onSectionFilterChange={setSectionFilter}
/>
{sectionFilter !== "library" ? (
<section className="flex flex-col gap-3">
<h2 className="text-base font-semibold text-foreground">
{t(I18nKey.MCP$INSTALLED_TITLE)}
</h2>
<InstalledServersSection
servers={filteredInstalledServers}
hasAnyInstalled={allServers.length > 0}
query={searchQuery}
onEdit={handleEdit}
onToggleEnabled={handleToggleEnabled}
/>
</section>
) : null}
{sectionFilter !== "installed" ? (
<MarketplaceSection
onSelect={handleMarketplaceInstall}
onAdd={handleMarketplaceInstall}
query={searchQuery}
/>
) : null}
</div>
{installEntry && (
<InstallServerModal
entry={installEntry}
existingServers={allServers}
onClose={() => setInstallEntry(null)}
/>
)}
{/* Custom (or non-marketplace) server editor. The empty-id
sentinel (`{ id: "", type: "sse" }`) means "add new". */}
{editingServer && (
<CustomServerEditor
server={editingServer}
existingServers={allServers}
onClose={() => setEditingServer(null)}
/>
)}
</main>
</div>
);
}