Curated Swift and SwiftUI best practices from leading iOS developers
swift-patterns-mcp
An MCP server providing curated Swift and SwiftUI best practices from leading iOS developers — with intelligent search, persistent memory, and optional premium integrations.
Want an Agent Skill?
If you want a lightweight, portable Swift/SwiftUI best-practices package without runtime tooling, check out:
swift-patterns-skill: Designed as a portable Agent Skill focused on Swift/SwiftUI patterns, architecture guidance, and decision-making frameworks.
Key difference:
- swift-patterns-skill = Static guidance (portable, no runtime)
- swift-patterns-mcp = Dynamic tooling (search, retrieval, premium features)
Note: This repo is an MCP server only. It does not ship an Agent Skill (SKILL.md) or skill references.
What does this MCP provide?
swift-patterns-mcp delivers runtime tools for accessing Swift/SwiftUI best practices:
- 🔎 Search & retrieval across curated sources
- 🧠 Persistent memory with cross-session recall
- 🔄 Auto-refreshing content from RSS feeds and GitHub
- 🎯 Intelligent filtering by quality and relevance
- 🔐 Premium integrations (optional Patreon support)
Ideal for:
- Active Development: "How do I implement pull-to-refresh in SwiftUI?" answered instantly without leaving your IDE
- Architecture Decisions: Compare MVVM vs. TCA patterns with concrete examples from trusted sources
- Staying Current: Access the latest patterns and best practices as they're published by leading iOS developers
- Team Standards: Build a searchable reference of approved patterns for your organization
- AI-Powered Workflows: Enable agents to query "Show me Sundell's approach to dependency injection" with consistent, quality responses
🌟 Features
- 🎓 Expert Knowledge Base: Patterns from Swift by Sundell, Antoine van der Lee, Nil Coalescing, and more
- 🔍 Intelligent Search: Query by topic, pattern, or specific iOS concept
- 💾 Persistent Memory: Cross-session recall with Memvid storage
- 🧠 Semantic Search: Optional AI-powered fallback for better conceptual matches
- 📚 Multiple Sources: Aggregates knowledge from trusted educators
- 🔄 Auto-Updates: Content refreshes automatically from RSS feeds
- ⚡ Fast Performance: Efficient caching and indexed search
Content Sources
Free Sources
These sources are publicly available but benefit from MCP's fetching, caching, and search capabilities:
| Source | Content Type | Updates |
|---|---|---|
| Swift by Sundell | Articles, patterns, best practices | Weekly |
| SwiftLee | Tutorials, tips, deep dives | Weekly |
| Nil Coalescing | SwiftUI patterns, Swift tips | Weekly |
| Point-Free | Open-source libraries, patterns | On release |
Premium Sources
Premium content requires OAuth authentication and active subscriptions:
| Source | What You Get | Authentication |
|---|---|---|
| Patreon | Premium content from supported creators | OAuth 2.0 |
Access exclusive content from top iOS educators: Kavsoft, SwiftUI Codes, sucodee and many more. Get tutorials, code samples, and expert guidance directly from creators you support.
📋 Prerequisites
- Node.js 18.0.0 or higher
- MCP-Compatible AI Assistant: Claude Desktop, Cursor, Windsurf, VS Code with Copilot, or Claude Code
🚀 Quick Start
Run Setup
npx -y swift-patterns-mcp@latest
In an interactive terminal, this opens the setup wizard.
When launched by an MCP client (non-interactive stdio), it runs as the MCP server automatically.
Interactive Setup Wizard
npx -y swift-patterns-mcp@latest setup
If installed globally, you can also run:
swift-patterns-mcp setup
The wizard helps you choose:
- Config scope (local project vs global)
- MCP client (Cursor, Claude Code, Windsurf, VS Code)
- Optional Patreon setup prompt
Non-interactive Setup (CI/Scripts)
# Cursor
npx -y swift-patterns-mcp@latest setup --cursor --global
npx -y swift-patterns-mcp@latest setup --cursor --local
# Claude Code
npx -y swift-patterns-mcp@latest setup --claude --global
# Windsurf
npx -y swift-patterns-mcp@latest setup --windsurf --global
# VS Code
npx -y swift-patterns-mcp@latest setup --vscode --local
# All clients
npx -y swift-patterns-mcp@latest setup --all --global
Use --global (-g) or --local (-l) to skip the location prompt.
Use --cursor, --claude, --windsurf, --vscode, or --all to skip the client prompt.
Configure Your AI Assistant
Cursor
](Tools (1)
search_patternsSearch and retrieval across curated Swift and SwiftUI sources.Configuration
{"mcpServers":{"swift-patterns":{"command":"npx","args":["-y","swift-patterns-mcp@latest"]}}}