swift-mcp

by efremidze

Not rated
GitHub

About

An MCP server that brings best practices from leading iOS developers directly to your AI assistant.

Details

Author
efremidze
Categories
Developer Tools, Other

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).

No reviews yet β€” be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.