swift-mcp
About
An MCP server that brings best practices from leading iOS developers directly to your AI assistant.
Details
- Author
- efremidze
- Categories
- Developer Tools, Other
Jump to
Setup
Install swift-mcp in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/efremidze/swift-mcp
Follow the installation instructions in the repository README, then restart your MCP client.
An MCP server providing curated Swift and SwiftUI best practices from leading iOS developers β with intelligent search, persistent memory, and optional premium integrations.
If you want alightweight, portable Swift/SwiftUI best-practices packagewithout runtime tooling, check out:
swift-patterns-skill: Designed as a portable Agent Skill focused on Swift/SwiftUI patterns, architecture guidance, and decision-making frameworks.
- 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 doesnotship an Agent Skill (SKILL.md) or skill references.
swift-patterns-mcpdelivers runtime tools for accessing Swift/SwiftUI best practices:
- πSearch & retrievalacross curated sources
- π§ Persistent memorywith cross-session recall
- πAuto-refreshing contentfrom RSS feeds and GitHub
- π―Intelligent filteringby quality and relevance
- πPremium integrations(optional Patreon support)
- 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
- π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
These sources are publicly available but benefit from MCP's fetching, caching, and search capabilities:
Premium content requires OAuth authentication and active subscriptions:
Access exclusive content from top iOS educators:Kavsoft,SwiftUI Codes,sucodeeand many more. Get tutorials, code samples, and expert guidance directly from creators you support.
- Node.js18.0.0 or higher
- MCP-Compatible AI Assistant: Claude Desktop, Cursor, Windsurf, VS Code with Copilot, or Claude Code
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.
If installed globally, you can also run:
- Config scope (local project vs global)
- MCP client (Cursor, Claude Code, Windsurf, VS Code)
- Optional Patreon setup prompt
# 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--allto skip the client prompt.
Or manually add toCursor SettingsβToolsβMCP Servers:
{ "mcpServers": { "swift-patterns": { "command": "npx", "args": ["-y", "swift-patterns-mcp@latest"] } } }
Alternatively, add to~/.cursor/mcp.json. SeeCursor documentationfor details.
claude mcp add swift-patterns -- npx -y swift-patterns-mcp@latest
{ "mcpServers": { "swift-patterns": { "command": "npx", "args": ["-y", "swift-patterns-mcp@latest"] } } }
Restart Claude Code and run/mcpto verify. SeeClaude Code MCP documentationfor details.
{ "mcpServers": { "swift-patterns": { "command": "npx", "args": ["-y", "swift-patterns-mcp@latest"] } } }
Restart Windsurf to activate. SeeWindsurf MCP documentationfor details.
{ "mcp": { "servers": { "swift-patterns": { "command": "npx", "args": ["-y", "swift-patterns-mcp@latest"] } } } }
Open.vscode/mcp.jsonand clickStartnext to the swift-patterns server. SeeVS Code MCP documentationfor details.
"Show me SwiftUI animation patterns" "What does Sundell say about testing?" "Explain navigation patterns in SwiftUI"
Configuration is automatically created at~/.swift-patterns-mcp/config.json:
{ "sources": { "sundell": { "enabled": true }, "vanderlee": { "enabled": true }, "nilcoalescing": { "enabled": true }, "pointfree": { "enabled": true }, "patreon": { "enabled": false, "configured": false } }, "prefetchSources": true, "semanticRecall": { "enabled": false, "minLexicalScore": 0.35, "minRelevanceScore": 70 }, "memvid": { "enabled": true, "autoStore": true, "useEmbeddings": false, "embeddingModel": "bge-small" } }
Note:configuredonly applies to premium sources. Free sources are treated as configured by default.
Memvid provides persistent semantic memory that improves recall across sessions. Unlike in-memory caching, Memvid stores patterns in a single-file database that persists between server restarts.
- πΎPersistent Storage: Patterns stored in~/.swift-patterns-mcp/swift-patterns-memory.mv2
- πCross-Session Recall: Find patterns from previous searches after server restart
- π§ Semantic Search: Optional embedding-based similarity search
- πAutomatic Storage: Patterns stored during searches
- β‘Fast Retrieval: Built-in BM25 + optional vector search
{ "memvid": { "enabled": true, // Enable Memvid persistent memory "autoStore": true, // Automatically store patterns during searches "useEmbeddings": false, // Use semantic embeddings (requires model download) "embeddingModel": "bge-small" // Options: "bge-small", "openai-small" } }
- You want patterns to persist across server restarts
- You frequently search for similar topics
- You need cross-session semantic memory
Note:Memvid complements MiniSearch (fast in-session search) and semantic recall (in-session fallback). All three work together:
- MiniSearch: Fast lexical search within current session
- Semantic recall: Activates for poor lexical results (in-session)
- Memvid: Cross-session persistent memory and recall
Semantic Recall (Optional AI Enhancement)
Semantic recall provides AI-powered semantic search as a fallback when keyword search returns poor results. It uses transformer embeddings to understand query intent and find conceptually similar patterns.
- π§ Automatically activates when keyword search scores are low
- π― Uses sentence transformers to understand meaning beyond keywords
- π Quality filtering to index only high-relevance patterns
- β‘ Efficient embedding caching
{ "semanticRecall": { "enabled": false, // Enable semantic recall "minLexicalScore": 0.35, // Activate when keyword search < 0.35 "minRelevanceScore": 70 // Only index patterns with score >= 70 } }
- 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.
All three variables are required for Patreon content fetching:
{ "mcpServers": { "swift-patterns": { "command": "npx", "args": ["-y", "swift-patterns-mcp@latest"], "env": { "PATREON_CLIENT_ID": "your_client_id", "PATREON_CLIENT_SECRET": "your_client_secret", "YOUTUBE_API_KEY": "your_youtube_api_key" } } } }
"How can I use lazy var in @Observable classes?" "Show me modern SwiftUI animation best practices using symbolEffect (with button + state examples)" "Explain common SwiftUI navigation patterns (NavigationStack, NavigationPath, enum routing) and when to use each"
"Build a coordinator-style architecture for SwiftUI: MVVM + dependency injection + type-safe routing" "Give me a clean infinite scrolling implementation: pagination, dedupe, cancellation, and loading states" "Explain how @Observable improves SwiftUI performance vs ObservableObject, then refactor my view model to @Observable"
"Build a SwiftUI parallax + sticky header screen like a profile page (include reusable component version)" "Show me how to build a photo editor flow: PhotosPicker -> crop -> filters -> export/share" "Give me 5 advanced SwiftUI micro-interactions (toasts, sheets, draggable cards, haptics) with production-ready code"
Access premium content from iOS creators you support:
- Verify environment variables are configured
- Complete OAuth authentication
- Fetch and verify content from your subscriptions
πDetailed Guide:Patreon Setup Documentation
- 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
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.
- β
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
# List all content sources and status swift-patterns-mcp sources # Interactive onboarding/configuration wizard swift-patterns-mcp setup # Patreon integration swift-patterns-mcp patreon setup # Connect your Patreon account swift-patterns-mcp patreon status # Check connection status swift-patterns-mcp patreon reset # Clear authentication data
graph LR A[AI Assistant] --> B[swift-patterns-mcp Server] B --> C[Free Sources] B --> D[Premium Sources] C --> E[Swift by Sundell RSS] C --> F[Antoine van der Lee RSS] C --> G[Nil Coalescing RSS] C --> H[Point-Free GitHub] D --> I[Patreon API]
- Query: Receives a query through the MCP protocol
- Processing: Searches enabled sources based on the query
- Content Retrieval: Fetches and parses content from RSS feeds, APIs, and cached data
- Quality Filtering: Applies configurable quality thresholds
- Response: Returns formatted, relevant patterns and examples
swift-patterns-mcp sources ls ~/.swift-patterns-mcp/config.json
- Ensure redirect URI is exactly:http://localhost:3000/patreon/callback
- Check no other process is using port 3000
- Verify OAuth credentials are correctly set
- Confirm you have active Patreon subscriptions to iOS creators
- Check status:swift-patterns-mcp patreon status
- Re-authenticate:swift-patterns-mcp patreon setup
- Core MCP server
- Swift by Sundell RSS
- Antoine van der Lee RSS
- Nil Coalescing RSS
- Patreon OAuth
- Point-Free GitHub
- Advanced filtering
- Additional premium sources
- More free sources
- Code validation
We welcome contributions! See ourcontributing guidelines.
MIT License - Copyright (c) 2026 Lasha Efremidze
- John Sundell- Swift by Sundell
- Antoine van der Lee- SwiftLee
- Nil Coalescing- SwiftUI patterns and Swift tips
- Point-Free- Advanced Swift education
β Star this repoβ’π Report Bugβ’β¨ Request Feature
This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.
Extentos is a multi-vendor development platform for adding smart-glasses capabilities to existing iOS and Android apps. The simplest analogy is Stripe for smart glasses
An MCP server tailored for React Nativeβfirst development using Gluestack UI
MCP Server for PGYER platform, supports uploading, querying apps, etc.
A CLI tool for developers to manage Android devices via ADB.
Drives an Android emulator or a real device over adb: screenshots, UI hierarchy with true device-pixel coordinates, tap and type, app lifecycle, logcat, and Gradle builds and tests.
Interact with Android devices using the Android Debug Bridge (ADB).
Interact with Android devices using the Android Debug Bridge (ADB).
AI 測試倧師 β MCP server driving pytest / Jest / Cypress / Go / Maestro. Analyze, generate, run, advise. Web + Mobile (iOS/Android/BlueStacks).
Control Android devices using the Android Debug Bridge (ADB).
Control Android devices via the Android Debug Bridge (ADB).
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.





