SuperAPI AI 工具集

mcp

智能体与模型

查看项目

更新于 10-15 19:57

技能介绍

用途:把 MCP 客户端接入 AFS 世界。MCP 只是传输通道,不引入第二套本体,连接后应优先使用实时 AFS 工具,而非反复阅读手册。

能力协商(本地优先):先判断可用的 MCP 路径,再假设工具存在。若 arc CLI 在 PATH 上,使用本地 stdio:插件 .mcp.json 中 server arc-local → arc mcp(桥接到守护进程,必要时自动启动)。若 arc CLI 不在 PATH 上,插件技能仍会加载,不要视为静默的彻底失败;可安装 CLI:curl -fsSL https://arc.afsd.io/install.sh | bash。自动安装 CLI 的插件引导属于 S5,尚未发布。远程/无 shell 主机在 v1 尚未就绪,arc-remote 有意未写入 .mcp.json,因此“未配置”不等于“端点宕机”,相关跟踪见 #6432(托管端点 + OAuth 授权)。应明确说明远程路径尚未就绪。

区分本地 MCP 启动失败原因:arc 缺失(command not found / spawn ENOENT),提示 needs arc on PATH,修复为安装 CLI;arc 存在但守护进程不可达(CLI 可运行但桥接无法附着或守护进程无法保持运行),提示 daemon unavailable,修复为 arc service start 或检查实例。

连接:arc mcp 用于桥接 stdio MCP 客户端与运行中的守护进程(按配置可自动启动守护进程);独立服务变体见 arc serve --transport mcp-*,可用 arc serve --help 查看。连接后(L1)优先使用实时 AFS 工具;多终端布局指引见 arc skill show afs 的 WM / multi-terminal 章节。

插件 .mcp.json(v1 仅本地,扁平格式,无 mcpServers 包装):{"arc-local": { "command": "arc", "args": ["mcp"] }}。Claude Desktop 用户配置(插件之外)仍使用 mcpServers 信封:{"mcpServers": {"AFS": {"command": "arc", "args": ["mcp"]}}}。

代理纪律:连接后用 MCP explore / tools 发现实时挂载与工具;不要把 MCP 工具列表当作离线 arc skill 引导的替代;变更仍走 AFS 语义(路径 write/exec),安全预期相同;若 MCP initialize 失败,查阅本技能的协商表,不要自行编造远程服务器条目。

相关:离线引导 arc skill list;守护进程 arc skill show daemon;路径操作 arc skill show afs;远程 MCP(推迟)见 GitHub issue #6432。