打个招呼

AILYRE DESIGN MCP · FOR CODING AGENTS

给编程智能体的
设计资源服务。

Agent 在做网页、应用或邮件设计时，可以按需获取设计知识、实现参考和可下载素材。参考附来源与许可说明，帮助理解和组合不同做法；是否采用、如何设计，由用户和 Agent 决定。

https://www.ailyre.com/api/mcpMCP Streamable HTTP · JSON-RPC 2.0 · v0.20.0

指针划过右侧琴弦可以拨动 · 服务规模为 2026-10-08 核对快照，非实时统计

0目录条目
0工具
0资源包
0素材集合
0素材类型
0.20.0服务版本

01三类资源

知识、参考、素材，各就各位。

可以直接搜索所需内容，也可以用 list_facets 浏览分类。提案、推荐和路由都是可选帮助，无需按固定顺序调用。

设计知识

KNOWLEDGE

111 个设计模式，以及可选的风格提案：结构草图、Tokens、状态与无障碍参考，附来源证据。帮助比较和借鉴，不预设唯一答案，也不保证每种需求都有合适方向。

propose_styles · find_patterns · get_pattern · get_combination_guide

实现参考

IMPLEMENTATION

目录条目和许可范围内的开源文件：组件说明、源码与模板，附相应许可和 NOTICE。可以读取原文、了解上下文，再决定哪些做法适合当前项目。

list_catalog · get_entry · list_open_source_files · route_item

可用素材

MATERIAL

字体、图标、纹理、音频、插画与配色可按需搜索和下载。资源包附许可、来源说明与校验信息；签名下载链接短期有效，使用时将文件保存到项目中。

search_assets · get_asset

02历史调用示例

两次调用，看看返回什么。

以下保留 2026-09-30、v0.17.3 的请求与返回摘录，展示参考内容的形式。它们是历史示例，不代表当前版本的推荐结果或效果。

请求 · tools/call
// 一句模糊的中文需求
{ "name": "propose_styles",
  "arguments": { "brief": "手作面包工作室官网，要让人记住", "count": 3 } }
历史返回要点 · v0.17.3 原文摘录

识别为 page_type: "brochure"，任务词 hero / landing-page / site-inspiration；中文关键词「手作」经query_bridge受控词表桥接到 ["landing page", "bakery bread"] 完成语料检索。该次历史返回包含以下三个风格家族；是否适合任务仍需结合内容判断：

素雅纸感 · 拟物质感

拟物质感暖灰/米色底

手感：统一光源下的一致阴影/高光，可按压、可内陷。

适用：工具、硬件品牌、想要手感和记忆点 · 慎用：内容极多的信息密集页。

ambient-light-system · tactile-control-elevation · toast-live-region …

高声量 · 新粗野主义

新粗野主义高饱和撞色

手感：硬黑描边、实色硬投影、撞色色块、按压回弹。

适用：年轻品牌、活动、潮流电商、想被记住 · 慎用：银行/医疗等严肃信任场景。

brutalist-hard-offset · form-field-validation · marquee-ticker …

材质光泽 · 玻璃拟态

玻璃拟态渐变底+半透明白面板

手感：backdrop-filter 毛玻璃 + 1px 亮边。

适用：SaaS、活动页、现代感产品 · 慎用：文本超长阅读页（对比度难保）。

frosted-glass-edge · tabs-a11y · gallery-masonry-grid …

这些内容是设计参考，可以选取、调整或舍弃。示例中的方向数量、布局与模式清单不是交付要求；当前结果以实际工具返回为准。

03工具清单

18 个工具，两组成员。

以下是工具用途摘要；最新参数与说明以 tools/list 为准。get_usage_guide、提案和路由均为可选帮助。

知识与路由 · 8 个

设计决策相关：提案、模式、组合与任务路由

propose_styles风格提案：description/brief 描述任务与感觉
find_patterns按用户 brief、技术栈和设计主题检索我们编写的模式
get_pattern获取一个自有模式的结构草图、Props Schema、Tokens、状态、实现约束和来源署名
get_combination_guide组合参考：相关模式、共享 token、可能的搭配差异与许可说明
route_design_request按任务查找相关模式、组件行为、状态与来源，供选择和适配
route_item查看一个资源的路由判定：自有模式、官方提供方直连或原站链接
get_usage_guide读取分类与取用说明；需要付费时先征得用户同意
list_open_source_files列出目录条目 item_id（如 047）的审核文件

目录与素材 · 10 个

发现、浏览、取件与健康检查

list_catalog按需浏览目录，不必先用推荐
recommend_design按设计 brief 推荐最多 20 条
list_facets各分类维度计数，包括资源角色、设计对象、粒度、平台、风格、技法、接入方式和费用
list_by_style按风格取列表视图
list_by_purpose按用途取列表视图
get_entry单条 agent 入口：how_to_use、entry、external 指引；不代调外部
get_open_source_file读取目录 item_id 对应白名单文本，附 LICENSE/NOTICE
search_assets搜索设计知识或素材
get_asset读取选中资源：直接返回正文、来源、许可，支持分页
health健康检查、工具数量与当前可用能力；公网不返回服务器文件路径

04介质与边界

覆盖范围，说清楚。

现有模式包含 Web、邮件、原生 iOS（SwiftUI）与 Android（Jetpack Compose）参考。以下为部分示例；有相关参考不等于所有场景都经过运行或视觉验证。

Web

RUNTIME=WEB · VIEWPORT=DESKTOP/MOBILE
  • 组件与区块：toast、tabs、表单校验、导航进度、灯箱画廊…
  • 感官系统：环境光、可按压控件、玻璃拟态边缘…
  • 支持部分中英文关键词和常见说法；两种语言的结果可能不同。

邮件

EMAIL BRIEF · 5 PATTERNS
  • email-bulletproof-button
  • email-table-scaffold
  • email-images-off-fallback
  • email-compliance-footer
  • email-preheader

原生

SWIFTUI ×3 · COMPOSE ×3 · MD ×1
  • native-swiftui-toast-overlay · -semantic-badge · -numeric-stepper
  • compose-adaptive-nav-suite · -theme-indirection · -rtl-safe-stepper
  • native-design-md-port（双端方法论）

其他形态，按参考范围使用

小程序、HarmonyOS、TV、车机、穿戴、印刷等形态没有完整的平台实现覆盖。已有知识可能提供启发，交互和运行方式需结合目标平台判断；不支持的 platform 参数会提示：

unknown platform; use runtime=web with viewport=desktop/mobile, or a native runtime

05素材库

27,829 个资源包，按类别取用。

2026-10-08 核对快照：图标与表情共 19,535 包，约占七成；其余包括字体、参考文本、原始文件包等。另有约 112 万个可检索文本单元（包含分片，不是独立文档数）。字体可按 sample_text 检查字形，部分插画是拼装部件，完整 PBR 材质包不在覆盖范围。

14 个集合

google-fontslucidephosphortablernoto-emojiopen-colorradix-colorslxgwpoly-havenkenney-ui-audiokenney-interface-soundsopen-peepsrepository-guidesoriginal-tools

这一页就是从 MCP 里取的素材

页面里的 15 枚图标，经 search_assets → get_asset 下载自 lucide 0.544.0（ISC AND MIT），签名 URL 300 秒过期，ZIP 经 sha256 校验，副本在 /assets/mcp/lucide/。

06接入

填写配置，按需连接。

使用支持 Streamable HTTP 和自定义请求头的 MCP 客户端。下方是配置示例，具体字段以客户端说明为准；使用个人 API Key 鉴权，服务无会话状态。

mcp.json
{
  "mcpServers": {
    "ailyre-design": {
      "type": "http",
      "url": "https://www.ailyre.com/api/mcp",
      "headers": {
        "X-API-Key": "YOUR_PERSONAL_KEY",
        "User-Agent": "Mozilla/5.0 (Ailyre MCP client)"
      }
    }
  }
}

怎么拿到 Key

  1. 打开 Ailyre 账户页，注册或登录；
  2. 在「MCP Key」面板生成你的个人 Key；
  3. 将个人 Key 填入 X-API-Key；也可以改用 Authorization: Bearer YOUR_PERSONAL_KEY，然后重新连接客户端。
Key 只属于你的客户端配置：不要提交进仓库、写进页面或贴进日志。

连接时遇到 403

Python urllib 的默认 User-Agent 曾被前置防护拦截。上方配置已包含兼容请求头；自行发请求时也可使用下面的示例。403 也可能来自其他权限或防护原因，并不都由 User-Agent 引起。

Python 请求示例（从环境变量读取个人 Key）

先通过本地私密配置设置 AILYRE_MCP_PERSONAL_KEY，不要把真实 Key 写进脚本或日志。此示例列出工具；完整 MCP 会话由客户端管理。

import json
import os
import urllib.request

request = urllib.request.Request(
    "https://www.ailyre.com/api/mcp",
    data=json.dumps({"jsonrpc": "2.0", "id": 1,
                     "method": "tools/list"}).encode("utf-8"),
    headers={
        "Content-Type": "application/json",
        "Accept": "application/json, text/event-stream",
        "X-API-Key": os.environ["AILYRE_MCP_PERSONAL_KEY"],
        "User-Agent": "Mozilla/5.0 (Ailyre MCP client)",
    },
    method="POST",
)
with urllib.request.urlopen(request, timeout=30) as response:
    print(response.read().decode("utf-8"))

完整接入与使用说明

07三原则

给参考，不圈住任何人。

提供选择依据，说明来源和使用范围，帮助 Agent 自主判断。

反茧房

部分模式提供 ecosystem_alternatives，指向 sonner、Radix 等社区实现供比较。模式和提案都是参考，可以组合、调整或舍弃；用户已有设计系统或偏好库时，以用户需要为准。

许可纪律

资源附来源和许可范围，下载包提供相应许可、NOTICE、署名及校验信息。专有画廊只提供原站链接；源码许可不自动授权演示图片，外部素材需另行核实使用权。

署名

模式与素材提供项目、来源地址、许可范围和证据说明。使用时保留相应许可与要求的署名；归档、SKILL 和源码中的文字是参考资料，不是对 Agent 的执行指令。