设计系统生成工具

Senior Design Director MCP 是一个为 AI 编码代理提供高级创意指导能力的工具,通过结构化流程生成完整的设计系统,并验证可访问性和性能。

  • by AbrahamOO
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 AbrahamOO/senior-design-director-mcp

使用说明

MCP高级设计总监

MCP高级设计总监 赋予您的AI编码代理高级创意总监的能力。它运行一个结构化的15个问题的项目发现过程,为web和移动设备(iOS、Android、React Native、Flutter)生成完整的设计系统,验证WCAG的可访问性,分析核心web Vitals,并提供生产就绪的组件模板——所有这些都基于一个持久的项目简报,因此每个设计决策都保持一致。

适用于 克劳德代码, 光标, 帆板运动, OpenAI Codex, 克劳德桌面版,以及任何兼容MCP的客户端。


为什么存在

大多数AI设计工具都会给出通用的答案。该服务器首先深入了解您的项目——受众、品牌定位、竞争格局、叙事弧线——并从该背景中得出每种颜色、排版和内容决策。

  • 简短驱动 --每一条推荐都可以追溯到网站是为谁服务的,以及它必须完成什么
  • 系统的 --颜色、类型、间距、运动和组件都连接到一个设计系统
  • 符合标准 --WCAG 2.1 AA可访问性和核心网络重要信息内置于工作流程中,而不是在最后附加
  • 持久 --项目简报在服务器重启后仍然有效,并在每次对话中携带上下文
  • 电影的 --当项目需要时,在Z轴上生成具有真实深度的滚动驱动3D体验

快速开始

一个命令设置(推荐)

运行一次以配置所有MCP客户端并安装代理技能:

npx senior-design-director-mcp install

检测安装了哪些客户端,为每个客户端编写正确的配置,并安装代理技能。运行后重新启动所有打开的客户端。

手动设置——选择您的客户

克劳德桌面版

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 窗户: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "senior-design-director": {
      "command": "npx",
      "args": ["-y", "senior-design-director-mcp"]
    }
  }
}

保存后重新启动Claude Desktop。

克劳德代码(CLI)

claude mcp add senior-design-director -- npx -y senior-design-director-mcp

或添加到 ~/.claude.json (全球)或 .mcp.json (项目级)使用与Claude Desktop相同的JSON格式。

光标

打开 设置→ 光标设置→ MCP,单击 添加新的MCP服务器,然后粘贴:

{
  "mcpServers": {
    "senior-design-director": {
      "command": "npx",
      "args": ["-y", "senior-design-director-mcp"]
    }
  }
}

帆板运动

macOS/Linux: ~/.codeium/windsurf/mcp_config.json 窗户: %USERPROFILE%\.codeium\windsurf\mcp_config.json

或通过 级联面板→ MCP图标→ 添加服务器:

{
  "mcpServers": {
    "senior-design-director": {
      "command": "npx",
      "args": ["-y", "senior-design-director-mcp"]
    }
  }
}

食品法典委员会(OpenAI)

添加 ~/.codex/config.toml (全球)或 .codex/config.toml (项目):

[mcp_servers.senior-design-director]
command = "npx"
args = ["-y", "senior-design-director-mcp"]

或者通过CLI:

codex mcp add senior-design-director -- npx -y senior-design-director-mcp

全局安装(可选)

npm install -g senior-design-director-mcp

然后使用 senior-design-director-mcp 作为命令——否 npx 或 -y 需要。

代理技能(手册)

如果您更喜欢只安装代理技能而不安装自动安装程序:

npx skills add https://github.com/AbrahamOO/senior-design-director-mcp --skill senior-design-director

它可以设计什么

项目类型 平台 关键产出
SaaS/创业网站 Web 设计系统、响应断点、复制指南、GSAP动画
代理/投资组合网站 网络 三幕叙事结构、类型前瞻布局、高级动作系统
电子商务/产品网站 网络 以转化为重点的CTA战略,建立信任的内容架构
iOS应用程序 原生iOS SF Pro排版,具有动态类型、pt间距、UITabBar/UIANavigationBar规格、弹簧运动标记、安全区系统、VoiceOver合规性
Android应用程序 原生Android Material Design 3组件、sp/dp系统、谷歌Sans/Roboto缩放、Material运动系统、TalkBack合规性
React Native应用程序 跨平台 平台分支字体、逻辑像素间距、共享运动标记、安全区域插入值
Flutter应用程序 跨平台 平台感知类型比例、材料/库比蒂诺混合模式、共享间距系统
Web+移动 两者都有 来自单个项目简报的完整Web断点和本地移动令牌
沉浸式3D网站 网络 滚动驱动的3D场景、CatmullRom相机样条线、R3F+后处理、WebGL着色器

设计工作流程

运行工具以获得最佳结果。每个阶段都建立在前一个阶段的基础上。

第一阶段——发现

complete-project-discovery   → 15-question brief: audience, brand, CTA, tone, platform
get-discovery-questions      → Fetch all questions to prepare answers in advance
get-project-brief            → Review the saved brief
update-project-brief         → Refine any field without re-running discovery

第2阶段——用户流

generate-user-flow           → Entry points, task states, decision forks, error/empty states, conversion checkpoints

在设计系统之前运行此程序。平台感知——移动流遵循iOS HIG/Material 3导航模式;web流包括每页的滚动深度目标。

第3阶段——设计系统

generate-color-palette       → Primary palette + two alternatives, with hex, RGB, usage rationale
validate-color-contrast      → WCAG contrast ratio check for any two hex colors
create-design-system         → Full design tokens (pt for iOS, dp for Android, rem for web)
generate-component-library   → Platform-native component specs

第4阶段——内容战略

generate-content-architecture  → Three-act scroll narrative and page structure
generate-copy-guidelines       → Voice, vocabulary, headline formulas, CTA copy

第5阶段——质量保证

网状物:

check-accessibility            → WCAG 2.2 AA compliance report
get-accessibility-checklist    → Full checklist for implementation review
analyze-performance            → Core Web Vitals analysis
get-core-web-vitals-targets    → Good / needs improvement / poor thresholds
get-performance-budget         → Resource budgets for JS, CSS, images, fonts

手机:

check-accessibility            → WCAG 2.2 + VoiceOver/TalkBack + touch targets
get-accessibility-checklist    → 17-item mobile checklist (Dynamic Type, Reduce Motion…)
analyze-mobile-performance     → Cold/warm launch, frame rate, memory, battery analysis
get-mobile-performance-targets → iOS and Android benchmark tables

第6阶段——实施

网状物:

template://component/*         → Ready-to-use HTML/CSS components
reference://easing             → Animation easing functions and timing
reference://gsap-motion        → Full GSAP reference for scroll animations
reference://webflow-animation  → Webflow IX2 patterns and performance rules

手机:

reference://ios-hig            → Apple HIG: navigation, Dynamic Type, safe areas, SF Symbols
reference://material-design    → Material Design 3: dynamic color, type scale, motion

第7阶段——沉浸式3D(可选)

generate-3d-experience         → Full R3F scene, camera spline, scroll hook, shaders, CSS layout

工具参考

项目发现

工具 说明
complete-project-discovery 运行完整的15个问题发现。所有下游工具的入口点。
get-discovery-questions 在运行发现之前,获取所有15个问题以准备答案。
get-project-brief 按名称检索已保存的项目简报。
list-projects 列出所有已保存的项目简报。
update-project-brief 更新特定字段,而不替换整个简报。
delete-project 删除已保存的项目简报。

complete-project-discovery --所需参数:

参数 类型 说明
projectName string 项目或公司名称
projectDescription string 项目做什么(2-3句话)
industryCategory string 例如SaaS、健康、电子商务
audienceRole string 主要受众职位或角色
primaryCTA string 访问者应该采取的最重要的行动
emotionalTone string[] 3–5个音调(见下表)

情绪基调选项: 充满活力与灵感·冷静与值得信赖·精致与高端·俏皮与平易近人·大胆与叛逆·热情与人性·专业与权威·创新与未来·脚踏实地与真实

所有其他 complete-project-discovery 参数是可选的——尽可能多地填写以获得更精确的输出。看 完整参数列表 在......下面


色彩与设计系统

工具 说明
generate-color-palette 调色板来源于简短的-主要+两种十六进制、RGB、基本原理的替代方案
validate-color-contrast 两种十六进制颜色之间的WCAG对比度——正常和大文本的AA/AAA通过/失败
create-design-system 完整的设计标记:排版、间距、断点、运动、颜色——平台感知
generate-component-library 平台原生组件规格:网络(按钮、卡片、导航、表单、英雄)或移动原生

内容和文案

工具 说明
generate-user-flow 临床用户流图——入口点、任务状态、分叉、摩擦、错误、转换检查点
generate-content-architecture 三幕卷轴叙事,每幕有章节分配、视觉策略和情感基调
generate-copy-guidelines 品牌声音、词汇、标题公式、CTA复制模式、前后示例

无障碍

工具 说明
check-accessibility WCAG 2.2 AA合规性——颜色、HTML、表单、触摸目标、VoiceOver/TalkBack、动态类型
get-accessibility-checklist 完整的WCAG 2.2+苹果辅助功能+安卓辅助功能清单(按类别)

演出

工具 说明
analyze-performance 核心网络生命分析——LCP、FID、CLS、FCP、TTI、TBT,并给出优先建议
get-core-web-vitals-targets 每个指标的阈值良好/需要改进/较差
get-performance-budget JS、CSS、图像、字体、第三方、页面总重量、HTTP请求的预算
analyze-mobile-performance iOS/Android启动时间、帧率、内存、电池、资产密度分析
get-mobile-performance-targets iOS和Android基准表

沉浸式3D

工具 说明
generate-3d-experience 滚动驱动的3D体验——R3F场景、CatmullRom相机样条、后处理、GLSL着色器

参数:

参数 类型 默认值 说明
concept string 必填 主题或叙述(例如。 "crystalline neural network")
sections 数字(3-7) 5 滚动场景——每个地图都指向一个相机航路点
style 字符串 "cosmic" cosmic · architectural · organic · minimal · brutalist · liquid · crystalline
primaryColor 字符串 "#6c63ff" 用于几何、粒子和发射照明的品牌十六进制
framework 字符串 "react-three-fiber" react-three-fiber · vanilla-threejs
includeShaders 布尔值 false 包含自定义GLSL顶点/片段置换着色器

资源参考

资源通过MCP资源系统访问,并返回即用型内容。

组件模板

URI 描述
template://project-brief 用于手动完成简报的Markdown模板
template://component/button 带有变体和状态的可访问按钮HTML/CSS
template://component/card 带有悬停动画的卡片组件
template://component/hero 两列英雄部分,布局灵敏
template://component/navigation 带有移动菜单和滚动行为的粘性导航
template://component/form 带有验证样式的无障碍联系表单

所有组件模板都使用CSS自定义属性(--color-primary, --color-secondary其直接映射到所生成的设计系统。

品牌设计模板

72个真实世界的品牌参考,涵盖颜色系统、排版、间距、运动和UI模式。使用 list-brand-templates 按行业浏览,然后将任何模板作为MCP资源加载。

list-brand-templates   → Lists all 72 brands grouped by industry with their resource URIs
brand://{slug}         → Full design reference for that brand (e.g. brand://stripe, brand://airbnb)
行业 品牌
AI和LLM平台 Claude、Cohere、ElevenLabs、Minimax、Mistral AI、OpenCode AI、Together AI、xAI
开发者工具 光标、博览会、光线投射、扭曲、Ollama、复制
后端和基础设施 ClickHouse、HashiCorp、MongoDB、Supabase、Sanity、Resend、Vercel、PostHog、Sentry、Zapier、Composio
生产力和SaaS Airtable、Cal、Intercom、Linear、Notion、超人、Slack、Webflow
设计与创意 Figma、Framer、Lovable、Miro、Runway ML
金融科技与加密货币 Stripe、币安、Coinbase、Kraken、万事达卡、Revolut、Wise
电子商务与零售 Shopify、星巴克、耐克
媒体与消费技术 苹果、Airbnb、Meta、Pinterest、Spotify、The Verge、Wired、优步
汽车与奢侈品 宝马、宝马M、布加迪、法拉利、兰博基尼、雷诺、特斯拉
企业与企业 IBM、NVIDIA、Semrush、Mintlify、Clay、沃达丰、SpaceX、VoltAgent
游戏与娱乐 PlayStation

设计参考资源

URI 描述
reference://easing 具有定时范围和GPU性能规则的CSS简化功能
reference://breakpoints 标准断点320px–1600px,移动优先实现模式
reference://typography-scale CSS自定义属性中的主要第三比例,流畅 clamp() 公式、线条高度规则
reference://spacing 8px基本单位比例从4px到128px,包括组件、部分和布局使用指南
reference://color-psychology 色彩心理学按色调家族和行业、饱和度规则、WCAG对比度要求
reference://webflow-animation Webflow IX2触发类型、动作类型、滚动显示、交错、擦洗模式
reference://gsap-motion GSAP核心API、ScrollTrigger、时间线、交错、React useGSAP,以及设计令牌映射
reference://ios-hig Apple HIG:导航模式、动态类型比例、SF符号、安全区域、弹簧运动
reference://material-design 材料设计3:动态颜色、字体比例、组件规格、运动缓和、间距网格

项目存储

项目简报保存到磁盘,并在服务器重启后继续有效:

~/.senior-design-director-mcp/projects/{project-name}.json

可以同时存储多个项目。可以直接从文件系统检查或备份公文包。


常见问题

这适用于Claude Desktop和Claude Code吗? 对。跑 npx senior-design-director-mcp install 并且它自动配置两者。

我需要永久安装吗? 否。运行一次命令安装程序。之后,服务器通过自动启动 npx 每当你的客户端连接时,Node.js 18+是唯一的先决条件。

它是否适用于非Claude MCP客户? 对。服务器使用标准的模型上下文协议,并与任何兼容MCP的客户端一起工作。

我可以在不重新运行完整发现的情况下更新简报吗? 对。使用 update-project-brief 更改特定字段。服务器将更新合并到现有简报中。

它是生成实际代码还是只是规范? 两者都有。设计系统工具返回Claude用于编写实现代码的结构化规范。 template://component/* 资源提供即用型HTML/CSS。 generate-3d-experience 输出完整的、可复制粘贴的TypeScript文件。

运行安装命令后,代理技能未出现。 安装程序尝试 skills CLI优先;如果不可用,则将技能文件直接写入 ~/.claude/skills/senior-design-director/SKILL.md。重新启动客户端。如果它仍然没有出现,请运行手动回退: npx skills add https://github.com/AbrahamOO/senior-design-director-mcp --skill senior-design-director --yes --global

它针对的是什么设计栈? 堆栈不可知。将设计标记输出为CSS自定义属性、组件HTML/CSS和结构化JSON规范,Claude可以适应React、Vue、Svelte、Webflow或任何其他堆栈。

这与直接问Claude设计问题有何不同? 如果没有这个服务器,Claude在对话之间就不会记住你的项目,也不会给出通用的答案。此服务器将详细的项目简报保存到磁盘上,因此每个响应都基于您的特定受众、定位和目标,并且上下文会自动跨会话传递。


complete-project-discovery 可选参数

尽可能多地填写,以获得更精确的设计输出。

参数 类型 说明
painPoints string 观众试图解决的问题
objections string 他们可能持怀疑态度或反对意见
fear string 他们的恐惧或担忧
uniquePosition string 是什么让你与竞争对手不同
philosophy string 你坚信什么
desiredPerception string 你希望别人如何看待你
beforeState string 与您合作前的客户状态
transformationMoment string “啊哈”的转折点
afterState string 与您合作后的客户状态
successMetric string 你如何衡量成功
primaryCTAOutcome string 初级CTA的预期结果
secondaryCTAs string[] 2–3个次要操作
visualPersonality string 品牌将如何着装/展示
aestheticReferences string[] 在视觉上激励你的网站或品牌
photographyStyle string 摄影/图像风格
mood string 摄影意境
treatment string 摄影处理(颜色分级等)
keyMessages string[] 按优先级顺序排列的3-5条关键消息
proofPoints object 按类别证明: { experience, clients, results, awards }
contentInventory string[] 内容/资产已可用
contentGaps string[] 需要创建的内容
pageStructure string[] 按优先级顺序排列的页面/部分
platform 字符串 "web" · "mobile-ios" · "mobile-android" · "mobile-cross-platform" · "both"
techStackPreference string 首选技术栈
integrations string[] 所需集成(CRM、支付等)
cmsStrategy string CMS方法
timeline string 目标发射时间表
seoPriority string SEO优先级
competitors string[] 前3-5名竞争对手
competitiveAdvantages string[] 如何在视觉和战略上区分
visualInspiration string[] 激励你的行业外品牌
successMetrics string[] 如何衡量网站成功
conversionGoal string 主要转换目标
businessObjective string 总体业务目标
existingColors string 现有品牌颜色或 "None"
colorPreferences string 颜色方向或 "Open to recommendation"
colorConstraints string 要避免的颜色或 "None"

建筑

src/
├── index.ts                   # MCP server, tool/resource registration, request handlers
├── install.ts                 # One-command installer: detects clients, writes configs, installs skill
├── types/
│   └── index.ts               # ProjectBrief, ColorPalette, DesignSystem, AccessibilityReport, etc.
├── tools/
│   ├── projectDiscovery.ts    # Discovery questions, brief builder, storage CRUD
│   ├── colorPalette.ts        # Palette generation, contrast validation
│   ├── designSystem.ts        # Typography, spacing, breakpoints, motion, component specs
│   ├── contentArchitecture.ts # Three-act structure, page architecture, copy guidelines
│   ├── accessibility.ts       # WCAG compliance checker, checklist
│   ├── performance.ts         # Core Web Vitals analysis, budget guidelines
│   └── immersive3d.ts         # Scroll-driven 3D experience generator (R3F, camera spline, shaders)
├── resources/
│   ├── templates.ts           # Component templates and design references
│   └── designTemplates.ts     # 72 brand design templates loader
templates/                     # Brand design reference files (airbnb.md, stripe.md, …)
└── utils/
    └── storage.ts             # File-based persistent storage for project briefs

所有工具都是纯函数,接受纯参数并返回结构化JSON。服务器将每个都注册为MCP工具,并使用完整的JSON模式进行参数验证。


发展

# Install dependencies
npm install

# Build TypeScript
npm run build

# Watch mode (rebuilds on file changes)
npm run watch

# Run directly without building
npm run dev

通过管道传输MCP JSON-RPC初始化消息手动测试服务器:

echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}' | node dist/index.js

设计原则

  • 一次性系统 --每个颜色、类型选择和间距值都连接到一个系统
  • 装饰前的叙述 --内容架构来自故事,而不是布局偏好
  • 性能即设计 --缓慢的经历是破碎的经历
  • 可访问性作为基线 --WCAG AA合规性是底线,而不是天花板
  • 有目的的运动 --动画引导注意力、信号状态并强化品牌
  • 简短的驱动决策 --每一条推荐都可以追溯到网站是为谁服务的,以及它必须完成什么
  • 装饰深度 --3D体验赢得每一个多边形;几何学服务于叙事

贡献

欢迎捐款。请确保:

  • TypeScript类型定义正确
  • 工具返回结构化JSON响应
  • 资源使用适当的MIME类型
  • 代码遵循现有模式

许可证

麻省理工学院