从项目需求出发
说清楚要做什么,按用途、技术栈和必需功能选型,把零散的仓库链接变成有依据的候选。
START BUILDING WEB / MCP
从一句建站需求,到有依据的模板选择。在对话中查找模板、寻找视觉参考、核对源码与许可,让下一步开发有一个更清楚的起点。
做一个摄影作品集,用 Astro。排版简洁、图片突出,许可证要求 MIT。
recommend_templatesmode "new-project"stack (exact) ["Astro"]license (SPDX) "MIT"项目适配 · 源码 · 许可证据 · 待核验项
01 / 服务特点
连接你的 Agent 与本站已发布的模板目录。先判断项目需要什么,再看界面长什么样,最后核对来源与适配边界。
说清楚要做什么,按用途、技术栈和必需功能选型,把零散的仓库链接变成有依据的候选。
米白色编辑风格,或深色数据仪表盘。直接描述配色与布局,在真实界面截图索引中寻找视觉参考。
把源码、可用的许可证据、采用说明与待核验项带回同一段对话。证据不足时明确说明,不把未知当成已实现。
02 / 从问题到工作流
只按框架搜,很难判断是否适合项目。
“找 Astro 摄影作品集模板,需要照片画廊和 MIT 许可证。”
获得候选、适配说明、源码与证据缺口,核对详情后再采用。
recommend_templates → get_template喜欢一种设计,却不知道该用什么关键词搜。
“米白背景、左侧导航、瀑布流图片,页面留白充足。”
查看匹配的截图作为视觉参考;已有公开参考网址时,可用获授权的后台视觉任务进一步比较。
search_visual_templates → get_template模板功能很多,不代表能改善已有项目。
“已有搜索和收藏,想补一个资源提交页面,帮我比较可用模板。”
使用 integrate 模式,说明已有能力、改善目标与整合范围,再比较收益、接入成本和取舍。
recommend_templates → compare_templates03 / 接入方式
使用支持 Streamable HTTP 与 Bearer 鉴权的 MCP 客户端。接入凭证独立授权,与网站账户登录态分开。
https://startbuildingweb.com/mcp联系服务维护方开通接入凭证,确认权限与有效期。当前采用单独授权方式。
联系维护方填写 HTTPS 服务地址与 Bearer 请求头。把凭证保存在客户端进程环境中,再重新加载连接。
初始化 MCP 连接,检查 tools/list。描述项目或视觉方向,再核对详情、比较候选后采用。
{
"mcpServers": {
"startbuildingweb": {
"url": "https://startbuildingweb.com/mcp",
"headers": {
"Authorization": "Bearer ${env:STARTBUILDINGWEB_MCP_TOKEN}"
}
}
}
}先在启动 Cursor 的进程环境中设置 STARTBUILDINGWEB_MCP_TOKEN,再重新加载 MCP。示例引用环境变量,不要把真实凭证提交到代码仓库。
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "recommend_templates",
"arguments": {
"project": {
"query": "用 Astro 搭建摄影作品集,展示照片画廊",
"mode": "new-project",
"requiredStacks": [
{
"name": "Astro",
"match": "exact"
}
],
"license": {
"allowedSpdx": [
"MIT"
],
"requireEvidence": true
}
},
"locale": "zh",
"limit": 3
}
}
}这是工具调用请求体,不是 REST 接口。先通过 MCP 客户端连接并初始化,再调用工具;当前参数以 tools/list 返回的 schema 为准。
{
"jsonrpc": "2.0",
"id": 3,
"method": "tools/call",
"params": {
"name": "search_visual_templates",
"arguments": {
"query": "米白背景、左侧导航、右侧瀑布流图片和充足留白",
"locale": "zh",
"limit": 3
}
}
}无需提供参考网址。描述你想要的外观,再查看返回预览;截图相似不能证明业务功能或动效已经实现。
直接使用 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(Model Context Protocol,模型上下文协议)让 AI 客户端用统一方式调用工具、读取数据。这个服务把本站的模板检索、视觉参考和来源资料接进你的工作流,让讨论项目与核对模板在同一处完成。
MCP 使用单独授权的 Bearer 凭证,有独立权限与有效期,网页登录态不能替代。当前由服务维护方开通,尚无公开自助领密钥或 OAuth 申请流程;配置客户端前请先联系维护方。
使用支持远程 Streamable HTTP 和 Bearer Authorization 请求头的 MCP 客户端。这里提供 Cursor 配置示例;其他客户端按各自配置格式接入,保存配置后还应实际确认工具发现成功。
目录检索、项目推荐和文字视觉检索返回选型信息,不会克隆、安装或覆盖你的项目。参考网址分析会创建私有后台任务。后续是否安装依赖或修改代码,是由你控制的独立操作。
外观相似不证明业务功能、动效、部署兼容或启动命令已验证。应查看冲突、未知项和核验状态;视觉检索只覆盖已建索引的部分,并返回覆盖信息,相似度是相对排序而不是命中百分比。
401/403 时核对凭证有效期与权限;429 时按 Retry-After 等待;后台任务按 pollAfterMs 轮询。目录版本变化时重新检索。没有匹配或证据不足是有效结果,应补充需求或核对缺口,不会为了凑数量擅自放宽约束。
把模板选型带回讨论项目的地方。