START BUILDING WEB / MCP

把模板选型,
接进你的 AI 工作流。

从一句建站需求,到有依据的模板选择。在对话中查找模板、寻找视觉参考、核对源码与许可,让下一步开发有一个更清楚的起点。

  • 项目需求与视觉检索
  • 附带来源的选型信息
  • 远程 MCP 接入
你的下一个项目工作流示意
描述需求

做一个摄影作品集,用 Astro。排版简洁、图片突出,许可证要求 MIT。

AI CLIENTSBW MCPCATALOG
tools/callrecommend_templatesmode "new-project"stack (exact) ["Astro"]license (SPDX) "MIT"
带回依据,而不只是一个链接。

项目适配 · 源码 · 许可证据 · 待核验项

01 / 服务特点

少一些来回搜索,
多一些选择的依据。

连接你的 Agent 与本站已发布的模板目录。先判断项目需要什么,再看界面长什么样,最后核对来源与适配边界。

从项目需求出发

说清楚要做什么,按用途、技术栈和必需功能选型,把零散的仓库链接变成有依据的候选。

用语言描述想要的外观

米白色编辑风格,或深色数据仪表盘。直接描述配色与布局,在真实界面截图索引中寻找视觉参考。

让选择有来源可查

把源码、可用的许可证据、采用说明与待核验项带回同一段对话。证据不足时明确说明,不把未知当成已实现。

02 / 从问题到工作流

三种场景,把模糊想法变成下一步。

01

为新项目选底座

只按框架搜,很难判断是否适合项目。

“找 Astro 摄影作品集模板,需要照片画廊和 MIT 许可证。”

获得候选、适配说明、源码与证据缺口,核对详情后再采用。

recommend_templates → get_template
02

找到想要的视觉方向

喜欢一种设计,却不知道该用什么关键词搜。

“米白背景、左侧导航、瀑布流图片,页面留白充足。”

查看匹配的截图作为视觉参考;已有公开参考网址时,可用获授权的后台视觉任务进一步比较。

search_visual_templates → get_template
03

给现有项目补能力

模板功能很多,不代表能改善已有项目。

“已有搜索和收藏,想补一个资源提交页面,帮我比较可用模板。”

使用 integrate 模式,说明已有能力、改善目标与整合范围,再比较收益、接入成本和取舍。

recommend_templates → compare_templates

03 / 接入方式

一个服务地址,
接进熟悉的工作环境。

使用支持 Streamable HTTP 与 Bearer 鉴权的 MCP 客户端。接入凭证独立授权,与网站账户登录态分开。

STREAMABLE HTTPhttps://startbuildingweb.com/mcp
  1. 1

    获取授权凭证

    联系服务维护方开通接入凭证,确认权限与有效期。当前采用单独授权方式。

    联系维护方
  2. 2

    配置客户端

    填写 HTTPS 服务地址与 Bearer 请求头。把凭证保存在客户端进程环境中,再重新加载连接。

  3. 3

    发现工具,开始调用

    初始化 MCP 连接,检查 tools/list。描述项目或视觉方向,再核对详情、比较候选后采用。

.cursor/mcp.json
{
  "mcpServers": {
    "startbuildingweb": {
      "url": "https://startbuildingweb.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:STARTBUILDINGWEB_MCP_TOKEN}"
      }
    }
  }
}

先在启动 Cursor 的进程环境中设置 STARTBUILDINGWEB_MCP_TOKEN,再重新加载 MCP。示例引用环境变量,不要把真实凭证提交到代码仓库。

直接使用 HTTP 时,发送 Authorization: Bearer <token>、Content-Type: application/json 和 Accept: application/json, text/event-stream,并完成 MCP 初始化握手。这不是匿名 REST 搜索接口。

04 / 工具说明

不同问题,交给对应的工具。

基础接入需要 templates:read;参考网址视觉任务还需要 visual:analyze。具体可用工具和参数,以你的凭证实际发现的列表为准。

recommend_templates只读选型信息

按项目需求推荐

说明用途、技术栈、必需功能与许可要求,区分直接匹配和需要改造的备选。当前最多推荐 3 个模板家族。

search_visual_templates只读选型信息

用文字找视觉参考

用中英文描述配色、排版和布局,检索已有真实界面截图索引。默认 3 条,最多 6 条;可筛选技术栈与许可。

search_templates只读选型信息

筛选模板目录

按关键词、技术栈、用途与许可证浏览当前发布的模板。每页最多 20 条,使用返回的分页游标继续读取。

get_template只读选型信息

核对模板详情

查看可用的源码、预览、许可证据、采用说明及待核验项。使用搜索结果中的模板 ID。

compare_templates只读选型信息

在同一标准下比较

对比 2–4 个模板的项目适配、证据和接入差距。使用同一目录版本的候选,避免只凭截图选型。

start_visual_recommendation后台视觉任务

从参考网站开始

提交公共 HTTPS 网页,创建私有后台截图与视觉比较任务。需要额外 visual:analyze 权限。

get_visual_recommendation后台视觉任务

读取视觉任务结果

使用同一凭证和返回的 jobId 读取进展与结果,按 pollAfterMs 建议轮询。需要 visual:analyze 权限。

规范筛选值可通过资源读取: startbuildingweb://taxonomy

05 / FAQ

接入前,你可能想了解。

权限说清楚,证据有边界,决定权留给你。

MCP 是什么,为什么要用这个服务?

MCP(Model Context Protocol,模型上下文协议)让 AI 客户端用统一方式调用工具、读取数据。这个服务把本站的模板检索、视觉参考和来源资料接进你的工作流,让讨论项目与核对模板在同一处完成。

登录网站就可以直接连接吗?

MCP 使用单独授权的 Bearer 凭证,有独立权限与有效期,网页登录态不能替代。当前由服务维护方开通,尚无公开自助领密钥或 OAuth 申请流程;配置客户端前请先联系维护方。

哪些客户端可以接入?

使用支持远程 Streamable HTTP 和 Bearer Authorization 请求头的 MCP 客户端。这里提供 Cursor 配置示例;其他客户端按各自配置格式接入,保存配置后还应实际确认工具发现成功。

调用后会自动安装、修改我的项目吗?

目录检索、项目推荐和文字视觉检索返回选型信息,不会克隆、安装或覆盖你的项目。参考网址分析会创建私有后台任务。后续是否安装依赖或修改代码,是由你控制的独立操作。

匹配成功就代表功能都已实现吗?

外观相似不证明业务功能、动效、部署兼容或启动命令已验证。应查看冲突、未知项和核验状态;视觉检索只覆盖已建索引的部分,并返回覆盖信息,相似度是相对排序而不是命中百分比。

调用失败或没有匹配怎么办?

401/403 时核对凭证有效期与权限;429 时按 Retry-After 等待;后台任务按 pollAfterMs 轮询。目录版本变化时重新检索。没有匹配或证据不足是有效结果,应补充需求或核对缺口,不会为了凑数量擅自放宽约束。

让下一个项目,从更清楚的选择开始。

把模板选型带回讨论项目的地方。