import { useEffect, useRef, useState } from 'react'; import type { FormEvent } from 'react'; import { AlertTriangle, Check, CircleAlert, Fingerprint, LoaderCircle, PlugZap, Plus, Power, RefreshCw, ShieldCheck, Terminal } from 'lucide-react'; import type { McpJob, McpRegistration, Session } from './types'; import { api } from './api'; import { Modal } from './components'; import { McpJobHistory } from './McpJobHistory'; import { useRecordPages } from './useRecordPages'; import { approvalLabels, mcpPermissionContext } from '../shared/contracts/execution-policy.mjs'; import './McpPanel.css'; const active = ['queued', 'connecting', 'discovering', 'calling', 'closing', 'stopping']; const stateName: Record = { verified: '握手已核验', unverified: '尚未探测', changed: '来源或契约异常' }; type View = { projectId: string; revision: number; protocolVersion: string; boundary: string; executionMode: string; limits: Record; registrations: McpRegistration[] }; type Draft = { name: string; executable: string; entry: string; timeoutMs: number }; export function McpPanel({ projectId, session, busy, approvalMode = 'ask', onSession, onError }: { projectId: string; session: Session | null; busy: boolean; approvalMode?: 'ask' | 'auto' | 'full'; onSession: (value: Session) => void; onError: (error: unknown) => void; }) { const [view, setView] = useState(null); const history = useRecordPages(session ? '/sessions/' + session.id + '/mcp/jobs' : null, onError), jobs = history.items; const [working, setWorking] = useState(false), [error, setError] = useState(''), [notice, setNotice] = useState(''); const [selectedTools, setSelectedTools] = useState>({}); const [draft, setDraft] = useState({ name: '', executable: '', entry: '', timeoutMs: 15000 }); const [probeTarget, setProbeTarget] = useState(null); const [requestError, setRequestError] = useState(''); const generation = useRef(0), revisions = useRef(new Map()), mounted = useRef(true); const url = '/projects/' + projectId + '/mcp'; const busyJobs = jobs.some(job => active.includes(job.status)); const locked = busy || busyJobs || working; const permission = mcpPermissionContext({ approvalMode }).action === 'execute' ? '任务中的已启用调用直接执行。' : '外部工具调用由工作台请求批准。'; useEffect(() => { mounted.current = true; return () => { mounted.current = false; generation.current++; }; }, []); async function load(current = generation.current) { const [nextView] = await Promise.all([api(url), history.refresh()]); if (!mounted.current || current !== generation.current) return; setView(nextView); setSelectedTools(previous => { const next = { ...previous }; for (const registration of nextView.registrations) if (revisions.current.get(registration.id) !== registration.configurationRevision) { next[registration.id] = [...registration.allowedTools]; revisions.current.set(registration.id, registration.configurationRevision); } return next; }); } useEffect(() => { const current = ++generation.current; setView(null); setError(''); setNotice(''); setProbeTarget(null); void load(current).catch(cause => { if (mounted.current && generation.current === current) setError(cause instanceof Error ? cause.message : String(cause)); }); return () => { if (generation.current === current) generation.current++; }; }, [projectId, session?.id]); useEffect(() => { if (!session || !jobs.some(job => active.includes(job.status))) return; const current = generation.current; const timer = window.setInterval(() => { void Promise.all([history.refresh(), api(url)]).then(([, nextView]) => { if (mounted.current && generation.current === current) setView(nextView); }).catch(cause => { if (generation.current === current) setError(cause instanceof Error ? cause.message : String(cause)); }); }, 900); return () => window.clearInterval(timer); }, [jobs, projectId, session?.id]); async function perform(action: () => Promise, message: string) { const current = generation.current; setWorking(true); setError(''); setNotice(''); try { await action(); if (current === generation.current) { setNotice(message); await load(current); } } catch (cause) { if (current === generation.current) setError(cause instanceof Error ? cause.message : String(cause)); } finally { if (current === generation.current) setWorking(false); } } function register(event: FormEvent) { event.preventDefault(); void perform(async () => { await api(url, { name: draft.name.trim(), executable: draft.executable.trim(), ...(draft.entry.trim() ? { entry: draft.entry.trim() } : {}), timeoutMs: draft.timeoutMs }); setDraft({ name: '', executable: '', entry: '', timeoutMs: 15000 }); }, '程序已登记并保持停用。请先实际探测,再选择允许的工具。'); } async function probe() { if (!probeTarget || !session) return; const target = probeTarget; setWorking(true); setError(''); setNotice(''); setRequestError(''); try { const result = await api<{ job: McpJob; session: Session }>('/sessions/' + session.id + '/mcp/probe', { id: target.id, configurationRevision: target.configurationRevision, confirm: true }); onSession(result.session); setProbeTarget(null); setNotice('探测已启动;完成后根据实际握手和参数契约选择工具。'); const current = generation.current; await load(current); } catch (cause) { setRequestError(cause instanceof Error ? cause.message : String(cause)); } finally { setWorking(false); } } async function stop() { if (!session) return; await perform(async () => { const updated = await api('/sessions/' + session.id + '/mcp/stop', {}); onSession(updated); }, 'MCP 操作已停止,已发出的调用若没有结果会保留为待核对。'); } const saveTools = (registration: McpRegistration) => perform(async () => { const value = await api(url + '/configure', { id: registration.id, configurationRevision: registration.configurationRevision, enabled: !!selectedTools[registration.id]?.length, allowedTools: selectedTools[registration.id] ?? [] }); revisions.current.set(value.id, -1); }, selectedTools[registration.id]?.length ? '已保存所选工具并启用。' + permission : '已停用该 MCP。'); const disable = (registration: McpRegistration) => perform(async () => { await api(url + '/configure', { id: registration.id, configurationRevision: registration.configurationRevision, enabled: false, allowedTools: [] }); revisions.current.set(registration.id, -1); }, '该 MCP 已停用,后续请求不会再发送它的工具目录。'); return
项目能力 / MCP

连接外部工具

登记本地 stdio 程序,探测实际握手后选择工具。{approvalMode === 'full' ? '完全访问权限下,任务中的已启用调用直接执行。' : '外部工具调用由工作台请求批准,提交调用后即可处理。'}

{view?.registrations.filter(item => item.enabled && item.status === 'verified').length ?? 0} 项已启用{view?.registrations.length ?? 0} 项已登记协议 {view?.protocolVersion ?? '2025-03-26'}{approvalLabels[approvalMode]} · {approvalMode === 'full' ? '直接执行' : '请求批准'}
{error &&

{error}

} {notice &&

{notice}

} {busy &&

当前项目正在执行;完成或停止后才能修改 MCP 配置。

}
{view?.boundary ?? '每次操作使用独立所属进程。进程隔离不等于 OS 沙箱,外部服务和程序可能拥有自己的网络或副作用。'}
{view?.registrations.length ?
{view.registrations.map(registration => { const chosen = selectedTools[registration.id] ?? registration.allowedTools; return

{registration.name}

{stateName[registration.status] ?? registration.status} · 配置修订 {registration.configurationRevision}

{registration.enabled ? '已启用' : '已停用'}
可执行文件{registration.launch.executable.path} SHA256 {registration.launch.executable.sha256.slice(0, 16)} · {registration.launch.executable.bytes.toLocaleString()} B
{registration.launch.entry &&
脚本入口{registration.launch.entry.path}SHA256 {registration.launch.entry.sha256.slice(0, 16)} · {registration.launch.entry.bytes.toLocaleString()} B
} {view.executionMode === 'unrestricted' ? '开放执行 · 不设请求超时' : '请求上限 ' + registration.timeoutMs.toLocaleString() + ' ms'}
{registration.reason &&

{registration.reason}

} {registration.contract &&
实际契约 SHA256 {registration.contract.sha256.slice(0, 16)} · 发现 {registration.tools.length} 项工具
} {registration.contract &&
允许模型请求的工具已选择 {chosen.length}{view.limits.allowedTools === null ? ' · 数量不限' : ' / ' + view.limits.allowedTools}
{registration.tools.map(tool => )} {!registration.tools.length &&

实际服务没有声明可发现工具。

}
}
{registration.contract && } {registration.enabled && } {busyJobs && session && }
; })}
: view &&
尚未登记项目 MCP

只登记你已审查的本地可执行文件。程序和 Node 入口会在探测及启用前重新计算 SHA256。

} {!view && !error &&

正在读取项目注册

}

登记本地 MCP

绝对路径 · 默认停用 · {view?.limits.registrations === null ? '登记数量不限' : '最多 ' + (view?.limits.registrations ?? 16) + ' 项'}
仅保留系统路径与临时目录环境,不传入模型 Key;不安装脚本、不使用 shell。
{session && } {!session &&

选择或创建一个任务会话后,可以对已登记程序执行探测。

} {probeTarget && { setProbeTarget(null); setRequestError(''); }}>
{probeTarget.name}{probeTarget.launch.executable.path}{probeTarget.launch.entry && {probeTarget.launch.entry.path}} 程序会以当前 Windows 用户权限运行;独立进程不等于 OS 沙箱。探测期间不会继承工作台模型凭据。
{requestError &&

{requestError}

}
}
; }