swift-patterns-mcp

🎯 Curated Swift/SwiftUI Patterns from Top iOS Developers

An MCP server providing curated Swift and SwiftUI best practices from leading iOS developers, including patterns and real-world code examples from Swift by Sundell, SwiftLee, and other trusted sources.

Quick Start • Features • Usage • Contributing

Why swift-patterns-mcp?

• ✅ Curated Content: Only high-quality patterns from trusted iOS developers

• ✅ Always Up-to-Date: Automatically fetches the latest articles and patterns

• ✅ MCP Native: Works seamlessly with Claude, Cursor, Windsurf, and other MCP-compatible tools

• ✅ Privacy First: Free sources require no authentication

• ✅ Extensible: Optional Patreon integration for premium content

🌟 Features

Core Features

• 🎓 Expert Knowledge Base: Provides patterns from Swift by Sundell, Antoine van der Lee, Nil Coalescing, and more

• 🔍 Intelligent Search: Query by topic, pattern, or specific iOS concepts

• 🎯 Quality Filtering: Configurable quality thresholds ensure only the best content

• 📚 Multiple Sources: Aggregates knowledge from various trusted educators

• 🔄 Auto-Updates: Content automatically refreshes from RSS feeds

• ⚡ Fast Performance: Efficient caching and indexed search

Built-in Sources (Free)

• ✅ Swift by Sundell - Articles, patterns, and best practices

• ✅ Antoine van der Lee - Tutorials, tips, and deep dives

• ✅ Nil Coalescing - SwiftUI patterns and practical Swift tips

• ✅ Point-Free - Open source libraries and patterns

Premium Sources (Optional)

• 🔐 Patreon Integration - Access premium content from creators you support

📋 Prerequisites

• Node.js: Version 18.0.0 or higher

• MCP-Compatible AI Assistant: Claude Desktop, Cursor, Windsurf, or VS Code with Copilot

🚀 Quick Start

Install

Configure Your AI Assistant

Cursor

Or manually add to Cursor Settings → Tools → MCP Servers:

.cursor/mcp.json:

Alternatively, add the following to your ~/.cursor/mcp.json file. To learn more, see the Cursor documentation.

Claude Code

Run this command in your terminal:

Or manually add to your project's .mcp.json file:

.mcp.json

After adding the configuration, restart Claude Code and run /mcp to see the swift-patterns MCP server in the list. If you see Connected, you're ready to use it.

See the Claude Code MCP documentation for more details.

Windsurf

Add the swift-patterns server to your project's .windsurf/mcp.json configuration file:

.windsurf/mcp.json

After adding the configuration, restart Windsurf to activate the MCP server.

See the Windsurf MCP documentation for more details.

VS Code

To configure MCP in VS Code with GitHub Copilot, add the swift-patterns-mcp server to your project's .vscode/mcp.json configuration file:

.vscode/mcp.json

After adding the configuration, open .vscode/mcp.json and click Start next to the swift-patterns server.

See the VS Code MCP documentation for more details.

Test It Out

Try these queries:

🔧 Configuration

The configuration file is automatically created at ~/.swift-patterns-mcp/config.json:

Semantic Recall (Optional AI Enhancement)

Semantic recall provides AI-powered semantic search as a fallback when traditional keyword search returns poor results. It uses transformer embeddings to understand query intent and find conceptually similar patterns.

Features:

• 🧠 Automatically activates when keyword search scores are low

• 🎯 Uses sentence transformers to understand meaning, not just keywords

• 📊 Quality filtering to only index high-relevance patterns

• ⚡ Efficient caching of embeddings

Configuration:

When to Enable:

• Your queries use conceptual terms that don't match exact keywords

• You want more intelligent, context-aware search results

• You're okay with slightly slower first-time searches (embeddings need to compute)

Note: Requires downloading a ~50MB transformer model on first use. Embeddings are cached for performance.

Environment Variables (Optional)

For premium features, add to your MCP client config:

💡 Usage Examples

Basic Queries

Advanced Queries

With Patreon Integration

📚 Content Sources

Free Sources

Currently supported, no authentication needed:

Premium Sources

Requires authentication and active subscriptions:

🔐 Premium Integration (Optional)

Patreon Setup

Access premium content from iOS creators you support:

Follow the interactive wizard to:

1. Create a Patreon OAuth application

2. Configure credentials

3. Complete authentication

📖 Detailed Guide: Patreon Setup Documentation

Requirements

• Active Patreon account with at least one iOS creator subscription

• Patreon Creator account (free - no need to launch a creator page)

• 10 minutes for one-time OAuth setup

Why Creator Account?

Patreon requires OAuth apps to be registered by creators. You don't need to launch a creator page or become an active creator - just register as one to create an OAuth app for personal use.

What You Get

• ✅ Access to premium tutorials and patterns from creators you support

• ✅ Automatic extraction of code from downloadable content

• ✅ Quality filtering and advanced search

• ✅ Multi-creator support

• ✅ Private, secure authentication

⚙️ Commands

🏗️ How It Works

1. Query: Receives a query through the MCP protocol

2. Processing: Searches enabled sources based on the query

3. Content Retrieval: Fetches and parses content from RSS feeds, APIs, and cached data

4. Quality Filtering: Applies configurable quality thresholds

5. Response: Returns formatted, relevant patterns and examples

🔧 Troubleshooting

Common Issues

Node version incompatible

Sources not returning results

Patreon Integration Issues

OAuth redirect not working

• Ensure redirect URI is exactly: http://localhost:3000/patreon/callback

• Check no other process is using port 3000

• Verify OAuth credentials are correctly set

No premium content showing

• Confirm you have active Patreon subscriptions to iOS creators

• Re-authenticate: swift-patterns-mcp auth patreon

• Check Patreon source is enabled: swift-patterns-mcp source list

🗺️ Roadmap

Current (v1.x)

• Core MCP server

• Swift by Sundell RSS

• Antoine van der Lee RSS

• Nil Coalescing RSS

• Patreon OAuth

• Point-Free GitHub

• Advanced filtering

Future (v2.x)

• Additional premium sources

• More free sources

• Code validation

🤝 Contributing

We welcome contributions! See our contributing guidelines.

📄 License

MIT License - Copyright (c) 2026 Lasha Efremidze

🙏 Credits

Created by Lasha Efremidze

Content Sources

• John Sundell - Swift by Sundell

• Antoine van der Lee - SwiftLee

• Nil Coalescing - SwiftUI patterns and Swift tips

• Point-Free - Advanced Swift education

Built with Model Context Protocol

Made with ❤️ for the Swift community

⭐ Star this repo • 🐛 Report Bug • ✨ Request Feature