swift-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 • Documentation • Examples • Contributing

📖 Table of Contents

• About

• Features

• Prerequisites

• Quick Start

• Installation

• Configuration

• Environment Variables

• Usage Examples

• Content Sources

• Premium Integration

• Commands

• How It Works

• Troubleshooting

• Documentation

• Roadmap

• Contributing

• License

• Credits

🎯 About

swift-mcp is a Model Context Protocol (MCP) server that provides your AI assistant with access to curated Swift and SwiftUI patterns, best practices, and code examples from top iOS developers and educators.

Whether you're building a new iOS app or looking for solutions to common Swift problems, swift-mcp gives your AI assistant the knowledge to provide expert-level guidance based on real-world patterns from the Swift community.

Why swift-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 you already support

🌟 Features

Core Features

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

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

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

• 📚 Multiple Sources: Aggregate 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

• ✅ Point-Free - Open source libraries and patterns

Premium Sources (Optional)

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

📋 Prerequisites

Before installing swift-mcp, ensure you have:

• Node.js: Version 18.0.0 or higher (Download)

• npm: Comes with Node.js

• MCP-Compatible AI Assistant: Such as:

  • Claude Desktop

  • Cursor

  • Windsurf

  • Any tool supporting the Model Context Protocol

🚀 Quick Start

Get started in less than 2 minutes:

Test It Out

In your AI assistant (Cursor, Claude, etc.), try:

You'll get curated patterns from Swift by Sundell, Antoine van der Lee, and other top sources!

📦 Installation

Global Installation (Recommended)

Configure Your AI Assistant

Cursor

Create or edit .cursor/mcp.json:

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

Windsurf

Create or edit .windsurf/mcp.json:

VS Code

Add to your VS Code MCP config:

Verify Installation

🔧 Configuration

Configuration File

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

Configuration Options

🔑 Environment Variables

swift-mcp uses environment variables for optional premium features. Free sources work without any configuration.

Available Variables

Setting Variables in MCP Client Config (Recommended)

The recommended way to configure environment variables is through your MCP client's configuration file. This passes variables directly to the swift-mcp server.

Cursor

Claude Desktop

Windsurf

VS Code

Local Development

For local development and testing, you can use a .env file in the project root:

1. Copy the example file:

   cp .env.example .env

2. Add your credentials:

   # .env PATREON_CLIENT_ID=your_client_id PATREON_CLIENT_SECRET=your_client_secret YOUTUBE_API_KEY=your_api_key

3. The .env file is automatically loaded when running the server locally.

Note: Never commit .env files to version control. The .env file is already in .gitignore.

💡 Usage Examples

Once installed, ask your AI assistant natural questions:

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 Integration

Unlock premium content from iOS creators you already support on Patreon.

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.

Setup Steps

1. Start the setup wizard:

   swift-mcp setup --patreon

2. Follow the interactive prompts to:

   • Create a Patreon OAuth application

   • Set up redirect URIs

   • Configure credentials

3. Complete OAuth authentication in your browser

4. Start using premium content immediately!

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

📖 Detailed Guide: Patreon Setup Documentation

⚙️ Commands

Source Management

Configuration

Authentication

🏗️ How It Works

1. AI Assistant Query: Your AI assistant sends a query through the MCP protocol

2. swift-mcp Processing: The server searches enabled sources based on your 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 to your AI assistant

🔧 Troubleshooting

Common Issues

Installation Problems

Error: Node version incompatible

Error: Permission denied during global install

Configuration Issues

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-mcp auth patreon

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

Getting Help

• 📖 Full Documentation

• 🐛 Report Issues

• 💬 Discussions

📚 Documentation

• Quick Start Guide - Get started in 2 minutes

• Patreon Setup Guide - Detailed Patreon integration instructions

• Project Structure - Technical architecture and codebase overview

🗺️ Roadmap

Current Focus (v1.x)

• Core MCP server implementation

• Swift by Sundell RSS integration

• Antoine van der Lee RSS integration

• Basic source management

• Patreon OAuth integration

• Point-Free GitHub integration

• Advanced quality filtering

• Code extraction from articles

Future Plans (v2.x)

• Additional premium source integrations

• More free content sources (developer blogs, newsletters)

• Advanced content discovery and recommendations

• Better content filtering and categorization

• Local content caching improvements

• Advanced search with vector embeddings

• Custom source plugins

Long-term Vision

• Community-contributed sources

• Pattern recommendation engine

• Code snippet validation

• Integration with Xcode

• Swift package ecosystem integration

🤝 Contributing

We welcome contributions! Whether it's bug reports, feature requests, or code contributions, we appreciate your help.

How to Contribute

1. Fork the repository

2. Create a feature branch: git checkout -b feature/amazing-feature

3. Commit your changes: git commit -m 'Add amazing feature'

4. Push to the branch: git push origin feature/amazing-feature

5. Open a Pull Request

Development Setup

Areas We Need Help

• 🐛 Bug fixes and testing

• 📝 Documentation improvements

• 🎨 Adding new content sources

• ⚡ Performance optimization

Code of Conduct

Please be respectful and constructive. We're here to build something great together!

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Credits

Created By

Lasha Efremidze - GitHub

Built With

• Model Context Protocol - The protocol enabling AI-to-tool communication

• TypeScript - Language and tooling

• rss-parser - RSS feed parsing

• Patreon API - Premium content integration

Content Sources

Special thanks to the iOS developers and educators whose content makes this possible:

• 🌟 John Sundell - Swift by Sundell

• 🌟 Antoine van der Lee - SwiftLee

• 🌟 Point-Free - Advanced Swift education

Inspiration

This project was inspired by the need to bring expert iOS knowledge directly into AI-assisted development workflows.

Made with ❤️ for the Swift community

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