mcpField
S
SeldonFrame

SeldonFrame

本地服务
github.com/seldonframeAI 与智能体679 周前更新

关于 SeldonFrame

SeldonFrame 是面向服务本地商家的代理机构的开源业务平台,可由编码 Agent 创建包含网站、预约、表单、CRM 和 AI Agent 的客户工作区。它还提供运行评估、发布和集中运营客户工作区的流程。

主要功能

  1. 01生成品牌化客户工作区
  2. 02创建网站、预约和接待表单
  3. 03配置 CRM 与 AI Agent
  4. 04运行评估并验证预订
  5. 05集中管理多个客户工作区
  6. 06支持自托管部署

适用场景

  1. 01为本地商家搭建线上业务入口
  2. 02为客户配置预约与接待 Agent
  3. 03发布前测试 Agent 和预约流程
  4. 04从 IDE 管理代理机构客户项目

MCP 相关

本地 MCP 服务通过工具让编码 Agent 创建和更新工作区;可从 Claude Code、Cursor、Windsurf 等 MCP 兼容环境使用。每个 Agent 还可提供签名 MCP 端点,供其他 LLM 租用。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"seldonframe": {
"command": "npx",
"args": [
"-y",
"@seldonframe/mcp"
]
}
}
}
启动命令npx -y @seldonframe/mcp

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npm@seldonframe/mcp

工具

156

收录的工具列表 · 更新于 2 周前

参数类型必填说明
business_namestring是企业显示名称(例如 'Summit Air Comfort')。
citystring是操作人员所在的城市。用于推断时区。
statestring是美国州代码或全名(也可以是加拿大省份)。用于推断时区。
phonestring是企业电话号码,格式不限。显示在导航栏、主视觉区和页脚中。
servicesarray是企业提供的服务/产品,每项使用普通字符串。分类器会读取这些内容,以选择合适的 CRM 类型(HVAC、法律、牙科、教练、代理机构或默认类型)。
business_descriptionstring是用一段话描述企业——此内容会影响主视觉区副标题、关于版块,以及(尤其重要的)类型分类器。请原样包含行业词语('residential HVAC'、'family-owned plumbing'、'dental practice')。
review_countnumber否可选——评价数量。显示在信任信息栏和主视觉区的证明指标中。
review_ratingnumber否可选——平均星级评分(例如 4.7)。显示在信任信息栏中。
certificationsarray否可选——资质,例如 ['EPA-certified', 'NATE-certified']。显示在信任信息栏中。
trust_signalsarray否可选——简短声明,例如 ['licensed', 'bonded', 'insured']。显示在信任信息栏中。
emergency_serviceboolean否可选——服务提供商提供全天候紧急服务。显示在导航栏和主视觉区域。
same_dayboolean否可选——提供当日服务。显示在信任信息栏中。
service_areaarray否可选——服务覆盖的城市或街区(例如 ['Scottsdale', 'Tempe'])。
emailstring否可选的联系邮箱,显示在落地页页脚中(不是服务提供商的账户邮箱——账户邮箱通过 finalize_workspace 提供)。
addressstring否可选的营业地址。

详细介绍

Seldon

SeldonFrame

销售 AI 前台。几分钟即可部署。

SeldonFrame 是面向服务本地商家的代理机构、以 Agent 为核心的开源 GoHighLevel 替代方案。将客户的网址交给你的编码 Agent,它就能在一个工作区中创建品牌网站、预约流程、客户接待、CRM 和 AI Agent。运行评测、发布并交接,然后即可通过一个代理机构视图管理所有客户。

License: AGPL v3 npm version GitHub stars Discord X smithery badge

网站 · 面向代理机构 · 面向构建者 · 文档 · Discord

在线演示: 暖通空调 · 医美水疗 · 医美水疗 · 减重


发布您的首个客户前台

claude mcp add seldonframe -- npx -y @seldonframe/mcp

或作为自动更新的 Claude Code 插件:

/plugin marketplace add seldonframe/seldonframe
/plugin install seldonframe@seldonframe
> Build a branded AI front office for my HVAC client in New Orleans.

  ✓ Workspace ready at acme-hvac.app.seldonframe.com

先构建客户工作区,再决定是否付费。托管版 Managed 使用 SeldonFrame 的密钥;Builder 和 Agency 方案采用 BYOK。您的代理机构拥有客户关系、工作区数据和交付利润。

亲眼看看实际效果——这是真实运行的工作区,不是模型图:

正在运行的 SeldonFrame 工作区——生成的网站,带有报价收集功能和聊天 Agent(右下角) 同一工作区的预约页面——Agent 实际使用的日历
生成的网站——报价收集、评价和聊天 Agent(右下角)预约页面——Agent 实际使用的日历

下面是该网站上的 Agent 处理真实来访请求的示例——它会查看实时日历;有人询问价格时,它不会编造答案(这是报价保护机制在发挥作用,并非预先编写的回复):

与网站聊天 Agent 的真实对话——它提供当日预约,并拒绝猜测价格

与线上网站聊天机器人的真实对话——没有预先编写的内容:

  • 它会读取真实日历。“今天的预约已经排满——这是明天上午 9 点、10 点和 11 点的时段。”
  • 它不会谎报价格。有人询问上门费用时,它会说“我手边没有确切价格,但在开始任何工作前,我会让技术人员确认费用。”——这是报价保护机制在发挥作用,而不是套用预设话术。
  • 它会确认信息以完成预约。它会询问服务地址以确认您是否在服务范围内,然后锁定时段。

同一个 Agent 也能通过短信和语音应答——只需更改配置即可切换渠道。

点击任意截图——这个 HVAC 工作区正在实际运行,并能预约真实服务。更多实际运行的工作区:Metro MedSpa · SKINNEY Medspa · Vive Ageless Weight Loss——以及 seldonframe.com 上的更多示例。


代理机构交付流程

  1. 从客户网址开始。 SeldonFrame 提取业务信息并创建工作区。
  2. 应用代理机构的操作手册。 设置网站、预约流程、信息收集、CRM 和 Agent 的品牌样式与配置。
  3. 交接前进行验证。 运行评估并完成一次真实测试预约。
  4. 发布并运营。 为客户提供品牌化门户,同时由您的代理机构保留主视图。

同一流程适用于控制面板、Claude Code、Cursor、Windsurf 或任何兼容 MCP 的 Agent。请参阅代理机构工作流。


Agent 在这里由什么构成

大多数“Agent 框架”只给您一个聊天循环,然后让您自求多福。SeldonFrame 为您的 IDE Agent 提供完整的生产环境架构:

Agent 模型——触发条件 × 技能 × 渠道

Agent 不是聊天机器人界面,而是由三个相互独立的维度构成:

  • 触发条件——何时运行:入站(收到来电 / 聊天 / 邮件 / SMS)· 事件(触发领域事件——booking.completed、lead.created、invoice.paid……)· 计划任务(按 cron 周期运行)。
  • 技能——做什么:接待 · 请求评价 · 快速跟进潜在客户 · 重新赢回客户 · 摘要……
  • 渠道——如何沟通:语音 · 网页聊天 · SMS · 邮件 · 内部摘要。
  • 工具——能操作什么:原生工具(根据真实日历预订 · 读取 / 写入 CRM · 发送 SMS 和邮件 · 留言)以及通过 Composio 集成的 1,000 多种应用(Google Calendar、Sheets、Slack、HubSpot、Notion 等),按 Agent 绑定。

surface: voice | chat(旧版仅适用于接待员的选项)只是这个空间中的一个点——trigger=inbound。一个构建器可以创建任何 Agent;市场可以销售任何 Agent。

从 Agent 到生产环境中的循环

生产级 Agent 是一个循环,而非单条提示词:

触发条件 →(模型 + 工具 + 状态)→ 验证 → 迭代,受停止条件约束,通过评估持续改进,并由可观测性 + 防护措施确保可靠。

路线图由两项不可妥协的原则推动:检查者必须与创建者分离(让模型给自己的工作打分,标准会过于宽松),以及循环必须有刹车(否则它会悄无声息地向你收费)。各项基础能力目前的状态如下:

基础能力状态当前内容
触发条件✅ 已发布SeldonEvent 总线上的入站 + 事件触发条件。booking.completed → 请求评价;lead.created → 快速跟进潜在客户;两者都会发送出站 SMS / 邮件。
状态✅ 已发布Brain v2 中的 Agent loop-memory——Agent 会在行动前回忆之前做过什么,并在行动后记录。“每位客户只请求一次评价”的限制现在通过记忆回忆实现,而非专用标记。
验证(创建者 ≠ 检查者)✅ 已发布确定性验证器会为每次运行评分——通过率显示在每个 Agent 的健康卡片和 /runs 中;run_agent_evals 会重放脚本化场景。正在逐步推出:将同一检查器用作发送前的强制关卡,并引入大模型评判器处理需要判断的情况。
防护措施 / 停止✅ 已发布报价防护(绝不编造价格)、预订前强制复述确认、每个联系人的频率限制、预订政策执行(营业时间 · 时长 · 必填字段)、通话 / 迭代次数硬性上限。正在逐步推出:针对长循环 Agent 的通用 token 预算刹车机制。
默认生成✅ 已发布一句英文 → 同步生成触发条件 + 技能 + 渠道 + 工具绑定 + 防护措施。“在工作完成后的第二天向每位客户发送短信,请求 Google 评价——每位客户仅发送一次,且仅在工作已完成时发送” 会被编译成一个真正的 Agent。generate_agent MCP 工具和 Studio 向导都会运行此流程。
录制 → Agent🗺 路线图无需描述流程——只需屏幕共享一次工作流。SeldonFrame 会观察操作,将步骤编译成 Agent 草稿(技能 + 工具绑定 + 根据录制内容生成的评估场景),几分钟内即可部署。现已通过功能标志在 /record 后台启用;接下来将成为默认入门方式。
用图展示循环
Agent 循环:终端中的一条构建命令;入站 / 事件 / 定时触发器驱动正在运行的 Agent 循环(模型 · 工具 · 状态 · 验证),原生工具与 Composio 工具环绕核心运行,Stop 刹车限制循环边界;每轮都会产生实际操作——预订日历、回短信给潜在客户、接听电话。

一句话即可构建;触发器驱动运行;环形结构就是正在运行的循环——模型 → 工具 → 状态 → 验证——工具环绕核心运行,/runs + Brain 负责观察,Stop 刹车限制每一轮的边界。图中的一切现已推出。(动画 SVG——如果你的查看器无法播放,静态画面表达的内容也一样。)


深入了解预先配置的技术栈、架构选择和路线图:docs/ARCHITECTURE.md。

今天就能推出的五种 Agent

触发器 × 技能 × 渠道是彼此独立的维度——每种各选一项,就设计好了一个 Agent:

Agent触发器技能渠道有意思的地方
AI 接待员入站电话资格确认 + 预订语音根据真实日历预订。报价保护、强制回读、通过 take_message 升级给负责人处理。
网站聊天机器人入站聊天同一套接待员技能网页嵌入同一蓝图,不同渠道——渠道可以互换。
快速跟进潜在客户lead.created 事件首次触达 + 资格确认短信表单提交后几秒内就会触发,直接来自事件总线。
评价请求器booking.completed 事件请求评价短信 / 电子邮件Brain 回忆机制确保“绝不向同一客户重复请求”。
任何你能描述的 Agent任意一句英文任意Studio 向导会根据 Agent 所需的基本要素调整提问。

Brain——不断积累的记忆

会忘事的 Agent 只是演示。每个 SeldonFrame 工作区都拥有一个 Brain:

  • Soul——Agent 据以构建的唯一事实来源(身份、服务、营业时间、定价)。安装他人的 Agent 后,它会基于你的 Soul 重新建立依据,绝不会沿用对方的事实。
  • 循环记忆——Agent 行动前会回忆,行动后会记录。“我已经请求这位客户评价了吗?”依靠的是记忆回忆,而非专门设置的标记。
  • 笔记 → 提炼后的规则——原始观察会按计划编译并提升为持久知识,因此每次运行都比上一次结束时更聪明。

内置资金流转机制

真正做事的 Agent 最终会接触真实资金——因此,这些机制是平台的基本功能,而不是集成项目:

  • 预付钱包账本——使用 UNIQUE 幂等键和受保护的非负扣减:费用不会重复扣取,余额也不会低于零。
  • Stripe Connect 付款——seldonframe payout 会将累计收益转入银行账户。
  • 可完成履约的结账——市场交易会自动配置部署,并根据买家的业务重新建立依据。
  • 按次租用计费——每个 Agent 都会提供一个已签名的 MCP 端点;其他大模型可以租用它,账本会按次计量。
  • 真实电话号码——为每个 Agent 配置一个号码(目前可自带 Twilio 号码;由 SF 管理的计量号码正在逐步推出)。

费用说明:只有在市场为你带来买家时,SeldonFrame 才会收取 5% 的 GMV 费用;通过你自己的 SeldonFrame 店铺销售时收取约 2%;其他情况一律 $0。


在任何 IDE 中操作每个客户端

一个 npm 包 — @seldonframe/mcp — 可在所有主流 AI 原生编辑器中作为本地 MCP 服务运行。选择你的编辑器,粘贴代码片段,然后让你的 Agent 一次性创建或更新客户工作区 — 网站、预约页面、接待表单、CRM 和 Agent。

Claude Code
claude mcp add seldonframe -- npx -y @seldonframe/mcp

也可以作为插件安装(自动更新,通过市场一行命令即可完成):

/plugin marketplace add seldonframe/seldonframe
/plugin install seldonframe@seldonframe
Cursor

添加到 ~/.cursor/mcp.json:

{
  "mcpServers": {
    "seldonframe": {
      "command": "npx",
      "args": ["-y", "@seldonframe/mcp"]
    }
  }
}
Windsurf

添加到 ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "seldonframe": {
      "command": "npx",
      "args": ["-y", "@seldonframe/mcp"]
    }
  }
}
VS Code(Copilot Agent 模式)

添加到 .vscode/mcp.json:

{
  "servers": {
    "seldonframe": {
      "command": "npx",
      "args": ["-y", "@seldonframe/mcp"]
    }
  }
}
Zed

添加到 settings.json:

{
  "context_servers": {
    "seldonframe": {
      "source": "custom",
      "command": "npx",
      "args": ["-y", "@seldonframe/mcp"]
    }
  }
}
Codex CLI

添加到 ~/.codex/config.toml:

[mcp_servers.seldonframe]
command = "npx"
args = ["-y", "@seldonframe/mcp"]

或者使用一行命令:codex mcp add seldonframe -- npx -y @seldonframe/mcp

连接后,重启 IDE(MCP 连接器会在会话启动时加载),然后直接这样说:

> Build a workspace for my client: [business name]. [city, state]. [services]. [phone, optional].

你也可以在 seldonframe.com/build 查看这六个保持同步的代码片段。


自托管整个项目

更愿意自行运行?整个 monorepo 采用 AGPL-3.0 许可 — 而且提供了预构建镜像,无需自行构建:

git clone https://github.com/seldonframe/seldonframe.git && cd seldonframe
cp .env.docker.example .env.docker   # add your ANTHROPIC_API_KEY or OPENAI_API_KEY
docker compose -f docker-compose.yml -f docker-compose.ghcr.yml up   # pulls the prebuilt image

启动 Postgres、迁移和运行于 localhost:3000 的应用 — 与托管版本使用相同的仪表板、生成的公开网站和 API。可使用多架构镜像(amd64 + arm64):ghcr.io/seldonframe/seldonframe;也可以运行 docker compose up --build 从源代码构建。请自备大模型密钥(Anthropic 或 OpenAI);短信/语音(Twilio)、电子邮件(Resend)和 1,000+ 种集成(Composio)均需自行添加密钥。完整指南:**QUICKSTART.md**。


准备好扩展业务时

你的代理机构中心是 seldonframe.com/agencies — 部署品牌化客户工作区、设置自己的客户定价,并保留总览视图。构建者仍可通过 seldonframe.com/build 发布可移植的 Agent,让其他大模型通过 MCP 租用。

定价 — 费用清晰明了

自托管$0 — AGPL-3.0,整个 monorepo · 运行 docker compose up 即可启动
构建者$29/mo · BYOK · 为你运营的企业提供工作区
托管版$49/mo · 由 SeldonFrame 管理的 AI · 一个工作区
代理机构入门版$99/mo · 白标 · 10 个客户工作区 · GMV 费率为 0%
代理机构成长版$199/mo · 30 个客户工作区 · GMV 费率为 0%
代理机构规模版$299/mo · 无限量客户工作区 · API/MCP + 市场访问权限 · GMV 费率为 0%
先构建,再结账免费创建第一个客户工作区,然后根据交付需求选择合适的托管方案
市场销售仅当买家由市场带来时收取 5%

技术栈

  • Next.js 16(App Router)+ React 19 + TypeScript — 一个可部署的应用:仪表板、生成的公开网站和 API
  • 基于 Postgres 的 Drizzle ORM(生产环境使用 Neon;自托管时可使用任意 Postgres 15+)
  • Tailwind CSS 4
  • pnpm workspaces + Turborepo(monorepo)
  • MCP 服务 — @seldonframe/mcp,纯 Node,可在 IDE 内本地运行
  • Anthropic / OpenAI(自备密钥)· Stripe 支付 · Twilio 语音/短信 · Resend 电子邮件

贡献

这里最有价值的 PR 是Agent 模板或垂直领域技能包——合并后的模板会发布到市场,供每位 SeldonFrame 用户查找,你也可以在旁边上架自己的付费版本。核心功能、连接器和评估相关的 PR 同样欢迎。

  • 先阅读 CONTRIBUTING.md,然后查看标记为 good first issue / help wanted 的议题
  • 项目规则:Agent 行为变更需附带评估场景;运行时变更需附带测试

社区

许可证

整个 monorepo 均采用 AGPL-3.0。可自由自托管;如果你修改了它并将其作为网络服务运行,这些修改也必须开源。如需闭源嵌入,托管方案是商业替代选择——请参阅 LICENSING.md。与 Mattermost、Plausible 和 Postiz 一样采用双重模式。

构建 Agent。出售它。获得报酬。——就在你的 IDE 中。

如果这正是你一直在寻找的平台,⭐ 为仓库点星——这有助于更多构建者发现它。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。