efremidze/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
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
If installed globally, you can also run:
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)