Swiftforge

SwiftForge MCP

精选、与时俱进、可用于生产环境的 SwiftUI 组件库，通过 MCP 直接提供给你的 AI 编码 Agent。

就像 21st.dev（为 AI Agent 精选的 React 组件），不过这是为 SwiftUI 打造的。

看看实际效果

https://github.com/user-attachments/assets/c2460a1d-fb0d-47e0-9d1b-91e6a784717b

快速浏览目录中的组件（包括 iOS 26 Liquid Glass），它们正在演示应用中运行。

问题所在

编码 Agent（Claude Code、Cursor、Copilot）擅长处理逻辑，但在 SwiftUI 方面表现平平。它们会：

• 使用已弃用的 API（到处都是 NavigationView、.foregroundColor、ObservableObject）
• 从未见过 iOS 26「Liquid Glass」（.glassEffect、GlassEffectContainer、.buttonStyle(.glass)），因此只能瞎猜
• 生成平淡、一次性的视图，而不是精致、可复用的组件

最后你只能一次又一次地手动重写它们生成的 SwiftUI 代码。

SwiftForge 的作用

SwiftForge 是一个轻量的 MCP 服务，让你的 Agent 可以按需访问人工精选的现代、可直接编译的 SwiftUI 组件。当你让 Agent「添加一张玻璃卡片」或「构建一个新手引导流程」时，它会获取真实、最新的组件，而不是凭空编造。

它的价值不在于服务本身，而在于精选目录：每个组件都只使用当前的 API，支持深色模式和 Dynamic Type，包含一个 #Preview，并经过审美审核。

快速开始

Claude Code

claude mcp add swiftforge -- npx -y swiftforge-mcp

Cursor / Windsurf（~/.cursor/mcp.json 或项目中的 .cursor/mcp.json）

{
  "mcpServers": {
    "swiftforge": {
      "command": "npx",
      "args": ["-y", "swiftforge-mcp"]
    }
  }
}

完整的设置说明、提示词示例和故障排除指南：docs/USAGE.md。

git clone <this repo> && cd swiftforge-mcp
npm install && npm run smoke
# then point your agent at: node /absolute/path/to/src/index.js

接下来，只需和你的 Agent 对话：

「使用 swiftforge 为此仪表板添加一张 Liquid Glass 统计卡片。」 「在 swiftforge 中搜索一个下拉刷新列表，并将它接入我的视图模型。」

演示应用 — 完整闭环，经过验证

examples/SwiftForgeDemo 是一个真正的 iOS 应用，它引入了目录中的全部 96 个组件，并可成功构建——证明整个流程正常运行（Agent → swiftforge → 可编译的 iOS 应用）：

npm run demo:gen      # (re)generate the demo project from the catalog
npm run demo:build    # headless xcodebuild for the iOS simulator
# or just open it:
open examples/SwiftForgeDemo/SwiftForgeDemo.xcodeproj

已在 Xcode 26 / iOS 26 模拟器上验证 ** BUILD SUCCEEDED **——包括 Liquid Glass 组件。应用会实时渲染几个组件（付费墙、OTP），并列出完整目录。

Agent 可用的工具

包含内容

涵盖 14 个类别的96 个精选组件：按钮与控件 · 卡片与容器 · 导航与栏 · 列表与滚动 · 列表与网格 · 表单与输入 · 图表 · 效果与 Liquid Glass · 反馈与浮层 · 媒体 · 身份验证与账户 · 动画 · 布局与框架 · 新手引导与主视觉——其中包括专门的 iOS 26 Liquid Glass 组件，并附有平滑降级说明。

每个组件都必须通过语法检查（scripts/validate.js、xcrun swiftc -parse）和高级审核，确保移除已弃用的 API。

📖 浏览所有组件 → docs/CATALOG.md

路线图

• 每次发布都会推出新组件，并随着 iOS 的发展持续更新。
• 有缺失的内容？提交问题——新增内容由大家的需求决定。

此处的目录免费提供，并采用 MIT 许可。

许可证

MIT（服务）。目录内容 © 其作者。