{
  "markdown": "<p align=\"center\">\n  <img src=\"assets/logo.svg\" width=\"104\" alt=\"SwiftForge logo\">\n</p>\n\n<h1 align=\"center\">SwiftForge MCP</h1>\n\n[![npm version](https://img.shields.io/npm/v/swiftforge-mcp.svg)](https://www.npmjs.com/package/swiftforge-mcp)\n[![license](https://img.shields.io/npm/l/swiftforge-mcp.svg)](LICENSE)\n[![MCP](https://img.shields.io/badge/MCP-server-blue.svg)](https://modelcontextprotocol.io)\n[![SwiftUI](https://img.shields.io/badge/SwiftUI-iOS%2017--26-orange.svg)](#)\n\n**A curated, current, production-grade SwiftUI component library — served straight to your AI coding agent over MCP.**\n\nThink [21st.dev](https://21st.dev) (curated React components for AI agents), but for **SwiftUI**.\n\n---\n\n## See it in action\n\n\nhttps://github.com/user-attachments/assets/c2460a1d-fb0d-47e0-9d1b-91e6a784717b\n\n\n_A quick tour of components from the catalog (incl. iOS 26 Liquid Glass), running in the demo app._\n\n---\n\n## The problem\n\nCoding agents (Claude Code, Cursor, Copilot) are *great* at logic and *mediocre* at SwiftUI. They:\n\n- reach for **deprecated APIs** (`NavigationView`, `.foregroundColor`, `ObservableObject` everywhere)\n- have **never seen iOS 26 \"Liquid Glass\"** (`.glassEffect`, `GlassEffectContainer`, `.buttonStyle(.glass)`) and guess wrong\n- produce **bland, one-off views** instead of polished, reusable components\n\nYou end up rewriting their SwiftUI by hand. Every time.\n\n## What SwiftForge does\n\nSwiftForge is a tiny **MCP server** that gives your agent on-demand access to a hand-curated catalog of **modern, compile-ready SwiftUI components**. When you ask your agent to \"add a glass card\" or \"build an onboarding flow,\" it pulls the real, current component instead of hallucinating one.\n\nThe value isn't the server — it's the **curated catalog**: every component uses current API only, is dark-mode + Dynamic Type friendly, includes a `#Preview`, and is reviewed for taste.\n\n## Quick start\n\n### Claude Code\n\n```bash\nclaude mcp add swiftforge -- npx -y swiftforge-mcp\n```\n\n### Cursor / Windsurf (`~/.cursor/mcp.json` or project `.cursor/mcp.json`)\n\n```json\n{\n  \"mcpServers\": {\n    \"swiftforge\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"swiftforge-mcp\"]\n    }\n  }\n}\n```\n\nFull setup, example prompts, and troubleshooting: **[docs/USAGE.md](docs/USAGE.md)**.\n\n<details>\n<summary>Run from a local clone (development)</summary>\n\n```bash\ngit clone <this repo> && cd swiftforge-mcp\nnpm install && npm run smoke\n# then point your agent at: node /absolute/path/to/src/index.js\n```\n</details>\n\nThen just talk to your agent:\n\n> \"Use swiftforge to add a Liquid Glass stat card to this dashboard.\"\n> \"Search swiftforge for a pull-to-refresh list and wire it to my view model.\"\n\n## Demo app — the closed loop, proven\n\n`examples/SwiftForgeDemo` is a **real iOS app** that pulls in all 96 catalog components and builds clean — proof that the full loop works (agent → swiftforge → a compiling iOS app):\n\n```bash\nnpm run demo:gen      # (re)generate the demo project from the catalog\nnpm run demo:build    # headless xcodebuild for the iOS simulator\n# or just open it:\nopen examples/SwiftForgeDemo/SwiftForgeDemo.xcodeproj\n```\n\nVerified `** BUILD SUCCEEDED **` on Xcode 26 / iOS 26 simulator — **including the Liquid Glass components**. The app live-renders a couple of components (paywall, OTP) and lists the full catalog.\n\n## Tools the agent gets\n\n| Tool | What it does |\n|------|--------------|\n| `list_categories` | See the catalog's categories + counts |\n| `list_components` | Browse components (optionally by category) |\n| `search_components` | Free-text search by what you're building |\n| `get_component` | Fetch one component's full, current SwiftUI source + usage + notes |\n\n## What's inside\n\n**96 curated components** across 14 categories: **Buttons & Controls · Cards & Containers · Navigation & Bars · Lists & Scroll · Lists & Grids · Forms & Inputs · Charts · Effects & Liquid Glass · Feedback & Overlays · Media · Auth & Account · Animations · Layout & Scaffolding · Onboarding & Hero** — including dedicated **iOS 26 Liquid Glass** components with graceful-fallback notes.\n\nEvery component is gated through a syntax check (`scripts/validate.js`, `xcrun swiftc -parse`) and a senior-review pass that strips deprecated API.\n\n📖 **Browse every component → [docs/CATALOG.md](docs/CATALOG.md)**\n\n## Roadmap\n\n- New components every release, kept current as iOS evolves.\n- Missing something? [Open an issue](https://github.com/jrlingyin888/SwiftNewModules/issues) — requests drive what gets added next.\n\nThe catalog here is free and MIT.\n\n## License\n\nMIT (server). Catalog content © its authors.\n",
  "bytes": 4618,
  "sha": "cede418cca4447a3cc2905707fc579fa4ffe6518013aceddcb778bbf1c23b1ff",
  "repo_slug": "jrlingyin888/swiftnewmodules",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_jrlingyin888_swiftforge_4730d045/readme"
}