SuperAPI AI 工具集

react-mcp

前端与建站

查看项目

更新于 10-15 17:20

技能介绍

用途:在 assistant-ui React 应用中让用户连接预设或自定义的 Streamable HTTP MCP 服务器,把每个已连接服务器的工具注册进 modelContext,工具名为 serverId__toolName,供模型调用。

主要能力:McpManagerResource 管理服务器与认证状态、持久化存储、把连接状态暴露给原语,并自动注册工具;defineConnector 声明应用预设连接器(不可移除),自定义服务器经 McpAddFormPrimitive 或 aui.mcp.addCustomServer(...) 添加;两者共享状态、存储、elicitation 与工具注册路径。安装样式化配置对话框:npx assistant-ui@latest add mcp-config,从 @/components/assistant-ui/elements/mcp-config.aui 导入 McpConfigDialog 并在 manager provider 下渲染,也可用无头原语自行组合。支持表单式 elicitation(用 McpElicitationPrimitive 在对应 mcpServer 作用域内渲染请求)、资源列表与读取、OAuth(含 PKCE 与 DCR)、bearer 与无认证、手动连接与断开。

必要用法:用 defineConnector 声明连接器,再通过 AuiConfig 扩展最近的 aui 作用域;connectionTimeout 为毫秒级 manager 默认值,连接器或自定义服务器可覆盖。聊天运行时需设置 sendAutomaticallyWhen: lastAssistantMessageIsCompleteWithToolCalls,使完成的前端工具调用返回模型继续。可用 aui.mcp.server({ id }).callTool(...) 在事件处理器中直接调用。OAuth 回调路由必须与 oauthRedirectUri 完全一致并在 provider 下渲染 McpOAuthCallback。

限制:工具必须已连接才能到达模型;McpLocalStorage 仅限浏览器且明文存 token,生产认证状态建议改用 HTTP only cookie 支撑的 McpCustomStorage;不要为用户切换存储,需重新挂载 manager。v1 暂不包含 prompts、sampling、带退避的自动重连、按工具持久化启用、按工具授权与内置 token 加密。缺失信息:定价与具体生效效果资料未提供。