跳到内容
MagicFrog

市场

在 web 上浏览市场,并把安装直接发送到你的桌面。

MagicFrog 市场是一份目录、两个入口:桌面应用内建的市场,和一个无需客户端即可使用的独立 web 站点。两者消费的是同一层聚合、同一批目录源,所以两个面对「存在什么」的回答保持一致。

web 站点

市场 web 站点是 MagicFrog 官网上的一个独立页面。浏览、搜索、分类过滤、精选推荐与最近更新流,全部无需账号、无需桌面客户端即可使用。每个列出的 server 都有详情页,展示其元数据、来源与安装动作。

该站点浏览的是 MCP server 目录:agent 可用的工具,来自官方 registry 加上已配置的自定义源,合并为一份列表;只想要官方目录时,有 official-only 过滤面。完整的三族目录——MCP server、插件与技能——与桌面市场渲染的是同一个数据层。

官方 registry 恒在,且不可移除。除此之外你可以配置自定义源——说同一套 registry API 形状的自有目录端点。

登录并发起安装

从 web 站点安装使用你的 MagicFrog 账号:

  1. 登录:输入账号标识与密码(与 MagicFrog 其余部分相同的账号门)。
  2. 发送安装。一次点击即在你的账号上排队一个安装项。
  3. 桌面来取。登录了同一账号的桌面客户端认领该项、执行安装,并落定结果。

当前存在两种安装载荷:

  • mcp——来自某个源的 MCP server(源 base URL 加 server 名);
  • plugin——一条插件 spec 字符串。

这就是如实的边界:技能可以在桌面市场里浏览,但 web 发起的安装目前只覆盖 MCP server 与插件。

队列如何运转

队列项只携带目录身份——绝不含预先构建好的安装配置。桌面端在执行时拿具体安装名与自己的已安装名集合核对,因为 web 侧无从得知你的桌面已经装了什么。

队列项在一张显式状态机中流转:

pending → claimed → executed | failed
   ↘ cancelled
  • 只有 pending 项可被认领;只有 claimed 项可被执行或标记失败;pending 与 claimed 项可被取消。终态不可变。
  • failed 项总带有显式原因。
  • 桌面端幂等执行:动作之前先查已处理 journal,成功之后才记录,所以重试绝不重复安装,结果未知的运行也绝不会被假标为已完成。

你的凭据在哪里

访问 token 只在 web 页面内存中保存,tab 开着就在,tab 关了就没——绝不写入浏览器存储。refresh token 则根本不会到达 web 客户端。离开页面会话即消失;下一次安装会要求你重新登录。桌面侧走的是账号的设备凭据通道,相互独立且可独立吊销。

桌面市场

桌面应用内嵌的市场展示同样三族内容,外加一个用于授权外部服务的 OAuth connectors 标签页。因为两个入口共享同一层聚合,web 上浏览到的与桌面上安装的,对「存在什么、装了什么」保持一致。