uiycs

685 个参考包        4,223 张截屏        685 段动效
217 个字体族        6,307 个图标名      750 个 Lottie 动画

  知识层        skill/uiycs-ui/SKILL.md
                以图为准的 UI 工作流，负责调用 MCP
        │
  服务层        mcp_server.py
                stdio · JSON-RPC 2.0 · MCP 2025-06-18 · 3 个工具
        │
  数据层        packs/  media/  fonts/  fonts-fontshare/  fonts-cjk/
                icons/  animated-icons/  index/

git clone https://github.com/Jensen-Yao/uiycs.git
cd uiycs
export UIYCS_HOME="$PWD"          # 所有脚本和 server 都以它为根

# 素材：从各自的公开源拉
python tools/collect_google_fonts.py     # 114 个 OFL 字族 → fonts/
python tools/collect_fontshare.py        # 100 个免费商用字族 → fonts-fontshare/
python tools/collect_icons.py            # lucide + heroicons + Material Symbols → icons/
python tools/harvest_lottiefiles.py      # LottieFiles 免费层 → animated-icons/
python tools/collect_lottie.py           # 精选 CDN 动画 → animated-icons/

# 参考包：装仓库自带的 3 个 demo，或用采集器自己建
cp -r examples/demo-packs/packs/* packs/
cp -r examples/demo-packs/media/* media/
# pip install playwright pillow && python -m playwright install chromium
python tools/capture_site.py https://your-product.com --name "Your Product"

# 建索引
python tools/build_fonts_index.py        # fonts/INDEX.json
python tools/build_icons_index.py        # icons/INDEX.json
python tools/build_pack_index.py         # index/index.json

// .mcp.json  (Claude Code / Cursor / Codex / ZCode / DSH 通用)
{
  "mcpServers": {
    "uiycs": {
      "command": "python",
      "args": ["/绝对路径/uiycs/mcp_server.py"],
      "env": { "UIYCS_HOME": "/绝对路径/uiycs" }
    }
  }
}

# ~/.codex/config.toml
[mcp_servers.uiycs]
command = "python"
args = ["/绝对路径/uiycs/mcp_server.py"]
env = { UIYCS_HOME = "/绝对路径/uiycs" }

echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}' \
  | UIYCS_HOME="$PWD" python mcp_server.py
# → serverInfo: {"name": "uiycs", "version": "2.0.0"}

cp -r skill/uiycs-ui ~/.agents/skills/

{ "query": "dark dashboard", "platform": "web", "limit": 2, "element": "Table" }

{ "query": "satoshi",       "kind": "font" }          // → 8 个 woff2，300–700 + 斜体
{ "query": "arrow-right",   "kind": "icon" }          // → 跨两套的 5 个 SVG
{ "query": "noto sans sc",  "kind": "font" }          // → 可变字体 TTF + 202 个网页分片
{ "query": "copy success",  "kind": "animated_icon" } // → 命中的 Lottie JSON

{ "id": "nominal" }   // 接受 id、slug 或精确名称

uiycs/
├── mcp_server.py               MCP server（stdio, JSON-RPC 2.0, MCP 2025-06-18）
├── skill/
│   └── uiycs-ui/
│       ├── SKILL.md            以图为准的 UI 工作流
│       └── references/
│           └── workflow.md     六步流程
├── examples/
│   ├── demo-packs/              3 个采集好的包（packs + media，681 KB）
│   └── README.md                装法 / 采集器用法 / schema 实例
├── tools/
│   ├── capture_site.py          把任意 URL 采成一个参考包（Playwright）
│   ├── collect_google_fonts.py
│   ├── collect_fontshare.py
│   ├── collect_icons.py
│   ├── collect_lottie.py
│   ├── harvest_lottiefiles.py
│   ├── build_fonts_index.py
│   ├── build_icons_index.py
│   └── build_pack_index.py
├── manifests/
│   ├── fonts.index.json        217 字族 / 2,292 文件
│   ├── icons.index.json        6,307 个名字 → 27,278 条 SVG 路径
│   ├── icons.manifest.json     每套的版本 / 许可 / 来源
│   ├── fontshare.manifest.json 100 字族
│   └── animated-icons.manifest.json
└── docs/
    ├── data-sources.md
    ├── mcp-reference.md
    └── rebuild.md

UIYCS_HOME             数据根目录。默认取仓库根；从 tools/ 里运行时自动上溯一级。
DOTLOTTIE_FIXTURES     可选。要一并纳入的 .lottie zip 样本目录。