SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场awwwards-setup

awwwards-setup

智能体与模型

查看项目

更新于 11-03 16:22

技能介绍

用途：Awwwards MCP Setup 是 awwwards MCP 服务器的首次引导技能。它解决的问题是：在第一次真正搜索之前，先确认用户希望以何种方式获得结果，并且只在确实会被使用时才安装可选的重型依赖；所有选择都会持久化，不会重复询问。

主要能力：

  1. 检查已有偏好。读取 ~/.awwwards-mcp/preferences.json（若设置了 AWWWARDS_CACHE_DIR 则以该缓存目录为准）。文件存在且字段齐全时静默应用并结束；仅缺失字段时才询问该字段；文件不存在则继续引导。
  2. 服务器未连接时先注册。若完全没有 awwwards 工具可用，说明服务器尚未注册，需按所用客户端添加：Claude Code 用 claude mcp add awwwards -- npx -y awwwards-mcp；Codex CLI 用 codex mcp add awwwards -- npx -y awwwards-mcp；OpenCode 在 opencode.json 中配置 mcp.awwwards（type 为 local，command 为 ["npx","-y","awwwards-mcp"]）；标准 mcpServers 客户端（Claude Desktop、Cursor、Windsurf、Gemini CLI、Cline、Continue）配置 mcpServers.awwwards（command 为 npx，args 为 ["-y","awwwards-mcp"]）。对 pi 则把该技能装入其技能目录，实时数据需借助其他支持 MCP 的智能体或扩展。注册后需重启智能体工具才会出现。无需 API key 和账号，要求 Node ≥ 22.13。
  3. 一次性收集偏好：结果密度（full 默认，每条结果带内联截图；compact 为简洁文本卡片，仅当页前两条带预览，对应 responseMode）；默认视口（desktop 1440×900 默认、mobile 390×844、或 both，对应 defaultViewport）；实况抓取（截图、结构图、动效录制、设计令牌导出、图片审计，需可选安装 playwright + chromium，约 120 MB，命令为 npm install -g awwwards-mcp playwright ffmpeg-static && npm exec --global -- playwright install chromium，随后需把注册命令从 npx -y awwwards-mcp 切换到已安装的 awwwards-mcp 并重启；对应 capturesEnabled）；本地索引（约 4 分钟、可续跑、之后自动后台刷新，命令为 npx -y -p awwwards-mcp awwwards-index，对应 autoIndex）；获奖监控（按工作室、标签或网址登记 watch_site，首次 list 仅建立基线，数据存于服务器缓存）。可选的 webcrack 可为 analyze_bundle 提供反混淆/解包模式。偏好以 JSON 写入偏好文件，包含 responseMode、defaultViewport、capturesEnabled、autoIndex、onboardedAt 等字段。
  4. 校验工具链：提示版本更新方式（npx -y awwwards-mcp@latest 或设置 AWWWARDS_AUTO_UPDATE=1）；确认 playwright 是否可用，失败则说明抓取工具不可用且不循环重试；缓存目录疑似损坏时转交 awwwards-doctor，不删除任何内容；若使用 AWWWARDS_MCP_PROFILE=v2，可用 get_index {request:{kind:"status"}} 或 search_references 探测整合后的接口，1.x 工具名出现在 v2 会话中属于路由错误而非安装故障。
  5. 报告并交接：用 2–3 行总结已存偏好、已安装/后台启动的内容，以及工作流的首个命令（通常是带已存 responseMode 的 search_sites）。后续方法位于 awwwards-inspiration（研究循环、获奖流、索引操作）、awwwards-motion-study（视频参考研究）和 awwwards-doctor（修复）。

使用方式：在 Awwwards MCP 服务器或其技能首次被调用于新会话/新机器、尚不存在偏好时触发；按上述步骤检查、注册、收集并持久化偏好、校验、汇报。之后用户要求修改（如改为 compact、移动端抓取）时更新偏好文件并一句话确认；再次运行该技能只询问缺失字段。

适用场景：首次配置 awwwards MCP 的开发者或设计研究用户；需要定制搜索结果展示密度、默认抓取视口；需要开启实况抓取或本地索引；需要在多台机器间保持一致偏好。

限制：本技能是安装与配置引导，不包含具体检索与研究方法；实况抓取依赖 playwright + chromium，未安装时相关工具会报错；pi 本身不支持 MCP，无法直接获得实时数据；环境变量 AWWWARDS_MCP_PROFILE 支持 core（13 个工具）、full（全部 41 个，默认）、v2（10 个整合工具加 5 个保留工具），切换需重启服务器；另有 AWWWARDS_MCP_MAX_RESPONSE_BYTES（默认 32 MB）、AWWWARDS_MCP_DEBUG_MEMORY、AWWWARDS_MCP_ATTACH 等选项，旧拼写 AWARDS_MCP_* 仅保留一个版本。收费、价格等信息暂未提供。