The fastest, cheapest, most efficient open-source agent harness. Run more than 500 agents on a $10 VPS.
Rust agent-orchestrationai-agentsai-assistantdesktopllmlocal-firstmcppersonal-aiprivacyrustsecond-braintauri
import debug from 'debug';
import { useEffect, useState } from 'react';
import { useT } from '../../../lib/i18n/I18nContext';
// `safeInvoke` (aliased to `invoke`) converts the CEF
// `window.ipc.postMessage` synchronous throw — Sentry TAURI-REACT-7 /
// TAURI-REACT-6 — into a rejected Promise that the existing try/catch sees
// as a regular IPC failure.
import { safeInvoke as invoke, isTauri } from '../../../utils/tauriCommands/common';
import ChipTabs from '../../layout/ChipTabs';
import { Alert, AlertDescription } from '../../ui';
import Button from '../../ui/Button';
import { SettingsSection } from '../controls';
import SettingsPanel from '../layout/SettingsPanel';
const log = debug('mcp-server-panel');
// ---------------------------------------------------------------------------
// Types
// ---------------------------------------------------------------------------
interface McpBinaryInfo {
path: string;
os: string;
}
type McpClient = 'claude-desktop' | 'cursor' | 'codex' | 'zed';
// ---------------------------------------------------------------------------
// Static tool catalogue
// ---------------------------------------------------------------------------
const MCP_TOOLS: { name: string; descriptionKey: string }[] = [
{ name: 'core.list_tools', descriptionKey: 'settings.mcpServer.tools.listTools' },
{ name: 'core.tool_instructions', descriptionKey: 'settings.mcpServer.tools.toolInstructions' },
{ name: 'agent.list_subagents', descriptionKey: 'settings.mcpServer.tools.listSubagents' },
{ name: 'agent.run_subagent', descriptionKey: 'settings.mcpServer.tools.runSubagent' },
{ name: 'memory.search', descriptionKey: 'settings.mcpServer.tools.memorySearch' },
{ name: 'memory.recall', descriptionKey: 'settings.mcpServer.tools.memoryRecall' },
{ name: 'tree.read_chunk', descriptionKey: 'settings.mcpServer.tools.treeReadChunk' },
{ name: 'tree.browse', descriptionKey: 'settings.mcpServer.tools.treeBrowse' },
{ name: 'tree.top_entities', descriptionKey: 'settings.mcpServer.tools.treeTopEntities' },
{ name: 'tree.list_sources', descriptionKey: 'settings.mcpServer.tools.treeListSources' },
];
// ---------------------------------------------------------------------------
// Config path helpers (mirrored from Rust for display only)
// ---------------------------------------------------------------------------
function configFilePathFor(client: McpClient, os: string): string {
const isWindows = os === 'windows';
const isMac = os === 'macos';
switch (client) {
case 'claude-desktop':
if (isMac) return '~/Library/Application Support/Claude/claude_desktop_config.json';
if (isWindows) return '%APPDATA%\\Claude\\claude_desktop_config.json';
return '~/.config/Claude/claude_desktop_config.json';
case 'cursor':
if (isWindows) return '%USERPROFILE%\\.cursor\\mcp.json';
return '~/.cursor/mcp.json';
case 'codex':
return '~/.codex/config.json';
case 'zed':
if (isMac) return '~/Library/Application Support/Zed/settings.json';
if (isWindows) return '%APPDATA%\\Zed\\settings.json';
return '~/.config/zed/settings.json';
}
}
// ---------------------------------------------------------------------------
// JSON snippet builders
// ---------------------------------------------------------------------------
function buildSnippet(client: McpClient, binaryPath: string): string {
if (client === 'zed') {
return JSON.stringify(
{ context_servers: { openhuman: { command: { path: binaryPath, args: ['mcp'] } } } },
null,
2
);
}
// Claude Desktop, Cursor, Codex
return JSON.stringify(
{ mcpServers: { openhuman: { command: binaryPath, args: ['mcp'] } } },
null,
2
);
}
// ---------------------------------------------------------------------------
// McpServerPanel component
// ---------------------------------------------------------------------------
interface McpServerPanelProps {
/** When true, skips the SettingsHeader/back-button affordances so the
* panel can be embedded in non-settings surfaces (e.g. the Connections
* page MCP Clients tab). */
embedded?: boolean;
}
const McpServerPanel = ({ embedded = false }: McpServerPanelProps = {}) => {
const { t } = useT();
const [binaryInfo, setBinaryInfo] = useState<McpBinaryInfo | null>(null);
const [binaryError, setBinaryError] = useState<string | null>(null);
const [activeClient, setActiveClient] = useState<McpClient>('claude-desktop');
const [copied, setCopied] = useState(false);
const [openConfigError, setOpenConfigError] = useState<string | null>(null);
// Resolve the binary path on mount.
useEffect(() => {
log('resolving mcp binary path');
invoke<McpBinaryInfo>('mcp_resolve_binary_path')
.then(info => {
log('mcp binary resolved: %s os: %s', info.path, info.os);
setBinaryInfo(info);
setBinaryError(null);
})
.catch(err => {
const msg = err instanceof Error ? err.message : String(err);
log('mcp binary resolution failed: %s', msg);
setBinaryError(msg);
setBinaryInfo(null);
});
}, []);
const binaryPath = binaryInfo?.path ?? null;
// When binary resolution fails, fall back to navigator.userAgent so Windows/Linux
// users see the correct config file path instead of the macOS default.
const os =
binaryInfo?.os ??
(/win/i.test(navigator.userAgent) && !/mac/i.test(navigator.userAgent)
? 'windows'
: /linux/i.test(navigator.userAgent)
? 'linux'
: 'macos');
const displayPath = binaryPath ?? t('settings.mcpServer.binaryPathNotFound');
const snippet = buildSnippet(activeClient, displayPath);
const configPath = configFilePathFor(activeClient, os);
const handleCopy = async () => {
try {
await navigator.clipboard.writeText(snippet);
setCopied(true);
setTimeout(() => setCopied(false), 2000);
} catch {
// Clipboard write failed — silently ignore.
}
};
const handleOpenConfig = async () => {
setOpenConfigError(null);
try {
await invoke('mcp_open_client_config', { client: activeClient });
} catch (err) {
const msg = err instanceof Error ? err.message : String(err);
setOpenConfigError(msg);
}
};
const clients: { id: McpClient; label: string }[] = [
{ id: 'claude-desktop', label: t('settings.mcpServer.clientClaudeDesktop') },
{ id: 'cursor', label: t('settings.mcpServer.clientCursor') },
{ id: 'codex', label: t('settings.mcpServer.clientCodex') },
{ id: 'zed', label: t('settings.mcpServer.clientZed') },
];
const body = (
<>
{/* ----------------------------------------------------------------- */}
{/* Section 1 — Available Tools */}
{/* ----------------------------------------------------------------- */}
<SettingsSection
title={t('settings.mcpServer.toolsSectionTitle')}
description={t('settings.mcpServer.toolsSectionDesc')}>
{MCP_TOOLS.map(tool => (
<div key={tool.name} className="flex items-start gap-3 px-4 py-3 bg-surface">
<span className="font-mono text-xs text-primary-700 dark:text-primary-400 mt-0.5 shrink-0">
{tool.name}
</span>
<span className="text-xs text-content-secondary dark:text-content-muted">
{t(tool.descriptionKey)}
</span>
</div>
))}
</SettingsSection>
{/* ----------------------------------------------------------------- */}
{/* Section 2 — Client Configuration */}
{/* ----------------------------------------------------------------- */}
<SettingsSection
title={t('settings.mcpServer.configSectionTitle')}
description={t('settings.mcpServer.configSectionDesc')}>
{/* Client selector tabs */}
<ChipTabs
ariaLabel={t('settings.mcpServer.clientSelectorAriaLabel')}
items={clients}
value={activeClient}
onChange={id => {
setActiveClient(id);
setOpenConfigError(null);
}}
/>
{/* Binary path error banner — resolved on mount, present before
the reader has done anything, so it must not interrupt with an
assertive announcement. */}
{binaryError && (
<Alert variant="destructive" density="compact" role={undefined} className="mx-4 mt-3">
<AlertDescription>{t('settings.mcpServer.binaryPathNotFound')}</AlertDescription>
</Alert>
)}
{/* Config file path */}
<div className="px-4 mt-3 mb-2 flex items-center gap-2">
<span className="text-xs text-content-muted shrink-0">
{t('settings.mcpServer.configFilePath')}:
</span>
<span className="text-xs font-mono text-content-secondary truncate">{configPath}</span>
</div>
{/* JSON snippet */}
<div className="mx-4 mb-3 rounded-xl overflow-hidden border border-line">
<pre className="bg-surface-muted dark:bg-surface/60 px-4 py-3 text-xs font-mono text-content overflow-x-auto whitespace-pre leading-relaxed">
{snippet}
</pre>
</div>
{/* Action buttons */}
<div className="px-4 pb-4 flex items-center gap-2 flex-wrap">
<Button type="button" variant="secondary" size="xs" onClick={() => void handleCopy()}>
{copied ? t('settings.mcpServer.copied') : t('settings.mcpServer.copySnippet')}
</Button>
{isTauri() && (
<Button
type="button"
variant="tertiary"
size="xs"
onClick={() => void handleOpenConfig()}>
{t('settings.mcpServer.openConfigFile')}
</Button>
)}
</div>
{/* Open config error — a result of the "Open config file" click
above, but not urgent enough to interrupt: polite, not
assertive. */}
{openConfigError && (
<Alert
variant="destructive"
density="compact"
role="status"
aria-live="polite"
className="mx-4 mb-3">
<AlertDescription>
{t('settings.mcpServer.openConfigError')}: {openConfigError}
</AlertDescription>
</Alert>
)}
</SettingsSection>
</>
);
// Embedded in Connections → MCP → Clients, whose page owns the header.
if (embedded) {
return <div className="space-y-5">{body}</div>;
}
return (
<SettingsPanel description={t('settings.developerMenu.mcpServer.desc')}>{body}</SettingsPanel>
);
};
export default McpServerPanel;