{"_id":"@efremidze/swift-mcp","_rev":"3-2d47946f5df341d9fe2474e959b49f21","name":"@efremidze/swift-mcp","dist-tags":{"latest":"1.0.2"},"versions":{"1.0.0":{"name":"@efremidze/swift-mcp","version":"1.0.0","keywords":["mcp","model-context-protocol","swift","swiftui","ios","learning","patterns","best-practices","patreon","youtube","ai-assistant","development-tools","claude","cursor","ai-coding"],"author":{"name":"Lasha Efremidze"},"license":"MIT","_id":"@efremidze/swift-mcp@1.0.0","maintainers":[{"name":"efremidze","email":"efremidzel@hotmail.com"}],"homepage":"https://github.com/efremidze/swift-mcp#readme","bugs":{"url":"https://github.com/efremidze/swift-mcp/issues"},"bin":{"swift-mcp":"build/index.js"},"dist":{"shasum":"2a71c13c98e96b8074a96e16c52dc7b8904d2ce7","tarball":"https://registry.npmjs.org/@efremidze/swift-mcp/-/swift-mcp-1.0.0.tgz","fileCount":18,"integrity":"sha512-wa8wfuCeoAGSw/00uje0Kyyeo6Cwrum1lpHkQzd1DgljVSjh365O+cMWuNS+rznwRwHBdrvLVLNKMSMBr1nLYA==","signatures":[{"sig":"MEQCIDsPsEQ9M4/6ggOVxMM1aCUkjjgrpJG+4izeMqcVSiikAiB+7Vv3ZcDffiKfZ4zCbULgF9/jI9K/31TscndFpUsMBA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":71993},"type":"module","engines":{"node":">=18.0.0"},"gitHead":"abc14993f529453d52e217e55ab7c2fe2faf43e7","scripts":{"build":"tsc","setup":"node build/cli/setup.js","watch":"tsc --watch","source":"node build/cli/source-manager.js","prepare":"npm run build"},"_npmUser":{"name":"efremidze","email":"efremidzel@hotmail.com"},"repository":{"url":"git+https://github.com/efremidze/swift-mcp.git","type":"git"},"_npmVersion":"10.9.2","description":"MCP server for Swift/SwiftUI learning with curated patterns from top iOS developers. Optional Patreon integration for premium content.","directories":{},"_nodeVersion":"23.11.0","dependencies":{"keytar":"^7.9.0","adm-zip":"^0.5.10","node-fetch":"^3.3.2","rss-parser":"^3.13.0","@modelcontextprotocol/sdk":"^1.0.4"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.2","@types/node":"^22.10.2"},"_npmOperationalInternal":{"tmp":"tmp/swift-mcp_1.0.0_1768253284846_0.5352528464106712","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@efremidze/swift-mcp","version":"1.0.1","keywords":["mcp","model-context-protocol","swift","swiftui","ios","learning","patterns","best-practices","patreon","youtube","ai-assistant","development-tools","claude","cursor","ai-coding"],"author":{"name":"Lasha Efremidze"},"license":"MIT","_id":"@efremidze/swift-mcp@1.0.1","maintainers":[{"name":"efremidze","email":"efremidzel@hotmail.com"}],"homepage":"https://github.com/efremidze/swift-mcp#readme","bugs":{"url":"https://github.com/efremidze/swift-mcp/issues"},"bin":{"swift-mcp":"build/index.js"},"dist":{"shasum":"b5d4355689a6dd59a5997b31c166848969f043e7","tarball":"https://registry.npmjs.org/@efremidze/swift-mcp/-/swift-mcp-1.0.1.tgz","fileCount":114,"integrity":"sha512-G02wXjSXkd+ZSQkPQOK4oIeArR9qp2wBFu1DW2xEWy3Wv5hDbAnOLIlcmf/b+751caOFGhBIvpOy0zNZH58Clw==","signatures":[{"sig":"MEUCIHzhchD25xiG0oo35tELljFaAZO76/P0hnoRGHSWqRsBAiEAmJq3acqmuiwTBdsSn+oPjmgQ4KXYluodi312OCeLCzM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":357628},"type":"module","engines":{"node":">=18.0.0"},"gitHead":"42fac7c74e014c51a082c5ec84c3c3818e653b35","scripts":{"auth":"node build/cli/auth.js","lint":"tsc --noEmit","test":"vitest run","build":"tsc","setup":"node build/cli/setup.js","watch":"tsc --watch","source":"node build/cli/source-manager.js","prepare":"npm run build"},"_npmUser":{"name":"efremidze","email":"efremidzel@hotmail.com"},"repository":{"url":"git+https://github.com/efremidze/swift-mcp.git","type":"git"},"_npmVersion":"10.9.2","description":"MCP server for Swift/SwiftUI learning with curated patterns from top iOS developers. Optional Patreon integration for premium content.","directories":{},"_nodeVersion":"23.11.0","dependencies":{"dotenv":"^17.2.3","keytar":"^7.9.0","adm-zip":"^0.5.10","natural":"^8.1.0","minisearch":"^7.2.0","node-fetch":"^3.3.2","patreon-dl":"^3.6.0","playwright":"^1.57.0","rss-parser":"^3.13.0","@modelcontextprotocol/sdk":"^1.0.4"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^3.2.4","typescript":"^5.7.2","@types/node":"^25.0.9","@types/adm-zip":"^0.5.7","@types/natural":"^5.1.5"},"_npmOperationalInternal":{"tmp":"tmp/swift-mcp_1.0.1_1768860294028_0.7152633208016295","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@efremidze/swift-mcp","version":"1.0.2","description":"MCP server for Swift/SwiftUI learning with curated patterns from top iOS developers. Optional Patreon integration for premium content.","type":"module","bin":{"swift-mcp":"build/index.js"},"scripts":{"build":"tsc","watch":"tsc --watch","prepare":"npm run build","setup":"node build/cli/setup.js","auth":"node build/cli/auth.js","source":"node build/cli/source-manager.js","lint":"tsc --noEmit","test":"vitest run"},"keywords":["mcp","model-context-protocol","swift","swiftui","ios","learning","patterns","best-practices","patreon","youtube","ai-assistant","development-tools","claude","cursor","ai-coding"],"author":{"name":"Lasha Efremidze"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/efremidze/swift-mcp.git"},"homepage":"https://github.com/efremidze/swift-mcp#readme","bugs":{"url":"https://github.com/efremidze/swift-mcp/issues"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.4","adm-zip":"^0.5.10","dotenv":"^17.2.3","keytar":"^7.9.0","minisearch":"^7.2.0","natural":"^8.1.0","node-fetch":"^3.3.2","patreon-dl":"^3.6.0","playwright":"^1.57.0","rss-parser":"^3.13.0"},"devDependencies":{"@types/adm-zip":"^0.5.7","@types/natural":"^5.1.5","@types/node":"^25.0.9","typescript":"^5.7.2","vitest":"^3.2.4"},"engines":{"node":">=18.0.0"},"_id":"@efremidze/swift-mcp@1.0.2","gitHead":"eb300cc213f96fb2c2516b0d37416c6da5a41f45","_nodeVersion":"23.11.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-tWpnuUuzDwlRdkK1SKhhblWCPdxb32lqgmQINm0mHwX+LkSvbmfQOwDJzugKfp12sbSU+dMTF1qt6sbdE7dGAg==","shasum":"31c8b4ab5b7470b96df8ca0cb748106014d674e6","tarball":"https://registry.npmjs.org/@efremidze/swift-mcp/-/swift-mcp-1.0.2.tgz","fileCount":163,"unpackedSize":347000,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIDeVu0f05iYBHpo2Olk54X8xBAJiHU7sCkKQ8JBuWpvOAiBVV3Ozrbona4WwzyTAWIvrVqikCUUezpXJ9MqE12CG3g=="}]},"_npmUser":{"name":"efremidze","email":"efremidzel@hotmail.com"},"directories":{},"maintainers":[{"name":"efremidze","email":"efremidzel@hotmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/swift-mcp_1.0.2_1768862486998_0.30046883650744527"},"_hasShrinkwrap":false}},"time":{"created":"2026-01-12T21:28:04.700Z","modified":"2026-01-19T22:41:27.251Z","1.0.0":"2026-01-12T21:28:04.983Z","1.0.1":"2026-01-19T22:04:54.218Z","1.0.2":"2026-01-19T22:41:27.154Z"},"bugs":{"url":"https://github.com/efremidze/swift-mcp/issues"},"author":{"name":"Lasha Efremidze"},"license":"MIT","homepage":"https://github.com/efremidze/swift-mcp#readme","keywords":["mcp","model-context-protocol","swift","swiftui","ios","learning","patterns","best-practices","patreon","youtube","ai-assistant","development-tools","claude","cursor","ai-coding"],"repository":{"type":"git","url":"git+https://github.com/efremidze/swift-mcp.git"},"description":"MCP server for Swift/SwiftUI learning with curated patterns from top iOS developers. Optional Patreon integration for premium content.","maintainers":[{"name":"efremidze","email":"efremidzel@hotmail.com"}],"readme":"# swift-mcp\n\n### 🎯 Curated Swift/SwiftUI Patterns from Top iOS Developers\n\n[![NPM Version](https://img.shields.io/npm/v/@efremidze/swift-mcp)](https://www.npmjs.com/package/@efremidze/swift-mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Node Version](https://img.shields.io/node/v/@efremidze/swift-mcp)](https://nodejs.org)\n\n**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.**\n\n[Quick Start](#-quick-start) • [Features](#-features) • [Usage](#-usage-examples) • [Contributing](#-contributing)\n\n---\n\n## 🎯 About\n\n**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.\n\nWhether 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.\n\n### Why swift-mcp?\n\n- ✅ **Curated Content**: Only high-quality patterns from trusted iOS developers\n- ✅ **Always Up-to-Date**: Automatically fetches the latest articles and patterns\n- ✅ **MCP Native**: Works seamlessly with Claude, Cursor, Windsurf, and other MCP-compatible tools\n- ✅ **Privacy First**: Free sources require no authentication\n- ✅ **Extensible**: Optional Patreon integration for premium content\n\n## 🌟 Features\n\n### Core Features\n\n- 🎓 **Expert Knowledge Base**: Access patterns from Swift by Sundell, Antoine van der Lee, and more\n- 🔍 **Intelligent Search**: Query by topic, pattern, or specific iOS concepts\n- 🎯 **Quality Filtering**: Configurable quality thresholds ensure only the best content\n- 📚 **Multiple Sources**: Aggregate knowledge from various trusted educators\n- 🔄 **Auto-Updates**: Content automatically refreshes from RSS feeds\n- ⚡ **Fast Performance**: Efficient caching and indexed search\n\n### Built-in Sources (Free)\n- ✅ **Swift by Sundell** - Articles, patterns, and best practices\n- ✅ **Antoine van der Lee** - Tutorials, tips, and deep dives\n- ✅ **Point-Free** - Open source libraries and patterns\n\n### Premium Sources (Optional)\n- 🔐 **Patreon Integration** - Access premium content from creators you support\n\n## 📋 Prerequisites\n\n- **Node.js**: Version 18.0.0 or higher\n- **MCP-Compatible AI Assistant**: Claude Desktop, Cursor, Windsurf, or VS Code with Copilot\n\n## 🚀 Quick Start\n\n### Install\n\n```bash\nnpm install -g @efremidze/swift-mcp\n```\n\n### Configure Your AI Assistant\n\n#### Cursor\n\n[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en-US/install-mcp?name=swift&config=eyJjb21tYW5kIjoibnB4IC15IEBlZnJlbWlkemUvc3dpZnQtbWNwQGxhdGVzdCJ9)\n\nOr manually add to **Cursor Settings** → **Tools** → **MCP Servers**:\n\n`.cursor/mcp.json`:\n```json\n{\n  \"mcpServers\": {\n    \"swift\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@efremidze/swift-mcp@latest\"]\n    }\n  }\n}\n```\n\nAlternatively, add the following to your `~/.cursor/mcp.json` file. To learn more, see the Cursor documentation.\n\n#### Claude Code\n\nRun this command in your terminal:\n\n```bash\nclaude mcp add swift -- npx -y @efremidze/swift-mcp@latest\n```\n\nOr manually add to your project's `.mcp.json` file:\n\n`.mcp.json`\n```json\n{\n  \"mcpServers\": {\n    \"swift\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@efremidze/swift-mcp@latest\"]\n    }\n  }\n}\n```\n\nAfter adding the configuration, restart Claude Code and run /mcp to see the HeroUI MCP server in the list. If you see Connected, you're ready to use it.\n\nSee the Claude Code MCP documentation for more details.\n\n#### Windsurf\n\nAdd the HeroUI server to your project's `.windsurf/mcp.json` configuration file:\n\n`.windsurf/mcp.json`\n```json\n{\n  \"mcpServers\": {\n    \"swift\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@efremidze/swift-mcp@latest\"]\n    }\n  }\n}\n```\n\nAfter adding the configuration, restart Windsurf to activate the MCP server.\n\nSee the Windsurf MCP documentation for more details.\n\n#### VS Code\n\nTo configure MCP in VS Code with GitHub Copilot, add the swift-mcp server to your project's `.vscode/mcp.json` configuration file:\n\n`.vscode/mcp.json`\n```json\n{\n  \"mcp\": {\n    \"servers\": {\n      \"swift\": {\n        \"command\": \"npx\",\n        \"args\": [\"-y\", \"@efremidze/swift-mcp@latest\"]\n      }\n    }\n  }\n}\n```\n\nAfter adding the configuration, open `.vscode/mcp.json` and click Start next to the heroui-react server.\n\nSee the VS Code MCP documentation for more details.\n\n### Test It Out\n\nIn your AI assistant, try:\n\n```\n\"Show me SwiftUI animation patterns\"\n\"What does Sundell say about testing?\"\n\"Explain navigation patterns in SwiftUI\"\n```\n\n## 🔧 Configuration\n\nThe configuration file is automatically created at `~/.swift-mcp/config.json`:\n\n```json\n{\n  \"sources\": {\n    \"sundell\": { \"enabled\": true, \"quality\": 60 },\n    \"vanderlee\": { \"enabled\": true, \"quality\": 60 },\n    \"pointfree\": { \"enabled\": false, \"quality\": 60 },\n    \"patreon\": { \"enabled\": false }\n  },\n  \"cache\": {\n    \"ttl\": 86400\n  }\n}\n```\n\n### Environment Variables (Optional)\n\nFor premium features, add to your MCP client config:\n\n```json\n{\n  \"mcpServers\": {\n    \"swift\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@efremidze/swift-mcp@latest\"],\n      \"env\": {\n        \"PATREON_CLIENT_ID\": \"your_client_id\",\n        \"PATREON_CLIENT_SECRET\": \"your_client_secret\"\n      }\n    }\n  }\n}\n```\n\n## 💡 Usage Examples\n\n### Basic Queries\n\n```\n\"Show me best practices for SwiftUI animations\"\n\"What does Sundell say about testing?\"\n\"Explain navigation patterns in SwiftUI\"\n```\n\n### Advanced Queries\n\n```\n\"Show me performance tips from van der Lee\"\n\"Find iOS architecture patterns for MVVM + coordinator\"\n\"Give me examples for SwiftUI infinite scrolling\"\n```\n\n### With Patreon Integration\n\n```\n\"Show me advanced SwiftUI patterns\"\n\"How do I build a photo editor app?\"\n```\n\n## 📚 Content Sources\n\n### Free Sources\n\nCurrently supported, no authentication needed:\n\n| Source | Creator | Content Type | Update Frequency |\n|--------|---------|--------------|------------------|\n| **Swift by Sundell** | John Sundell | Articles, patterns, best practices | Weekly |\n| **Antoine van der Lee** | Antoine van der Lee | Tutorials, tips, deep dives | Weekly |\n| **Point-Free** | Point-Free | Open source libraries, patterns | On release |\n\n### Premium Sources\n\nRequires authentication and active subscriptions:\n\n| Source | What You Get | Setup Method | Status |\n|--------|--------------|--------------|--------|\n| **Patreon** | Premium content from iOS creators | OAuth 2.0 | ✅ Available |\n\n## 🔐 Premium Integration (Optional)\n\n### Patreon Setup\n\nAccess premium content from iOS creators you support:\n\n```bash\nswift-mcp setup --patreon\n```\n\nFollow the interactive wizard to:\n1. Create a Patreon OAuth application\n2. Configure credentials\n3. Complete authentication\n\n📖 **Detailed Guide**: [Patreon Setup Documentation](docs/PATREON_SETUP.md)\n\n#### Requirements\n\n- Active Patreon account with at least one iOS creator subscription\n- Patreon Creator account (free - no need to launch a creator page)\n- 10 minutes for one-time OAuth setup\n\n#### Why Creator Account?\n\nPatreon 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.\n\n#### What You Get\n\n- ✅ Access to premium tutorials and patterns from creators you support\n- ✅ Automatic extraction of code from downloadable content\n- ✅ Quality filtering and advanced search\n- ✅ Multi-creator support\n- ✅ Private, secure authentication\n\n## ⚙️ Commands\n\n```bash\n# Source management\nswift-mcp source list\nswift-mcp source enable <source-name>\nswift-mcp source disable <source-name>\n\n# Configuration\nswift-mcp setup\nswift-mcp setup --patreon\n\n# Authentication\nswift-mcp auth patreon\nswift-mcp auth status\n```\n\n## 🏗️ How It Works\n\n```mermaid\ngraph LR\n    A[AI Assistant] --> B[swift-mcp Server]\n    B --> C[Free Sources]\n    B --> D[Premium Sources]\n    C --> E[Swift by Sundell RSS]\n    C --> F[van der Lee RSS]\n    C --> G[Point-Free GitHub]\n    D --> H[Patreon API]\n```\n\n1. **AI Assistant Query**: Your AI assistant sends a query through the MCP protocol\n2. **swift-mcp Processing**: The server searches enabled sources based on your query\n3. **Content Retrieval**: Fetches and parses content from RSS feeds, APIs, and cached data\n4. **Quality Filtering**: Applies configurable quality thresholds\n5. **Response**: Returns formatted, relevant patterns and examples to your AI assistant\n\n## 🔧 Troubleshooting\n\n### Common Issues\n\n**Node version incompatible**\n```bash\nnode --version  # Should be >= 18.0.0\n```\n\n**Sources not returning results**\n```bash\nswift-mcp source list\nls ~/.swift-mcp/config.json\nswift-mcp setup\n```\n\n#### Patreon Integration Issues\n\n**OAuth redirect not working**\n- Ensure redirect URI is exactly: `http://localhost:3000/patreon/callback`\n- Check no other process is using port 3000\n- Verify OAuth credentials are correctly set\n\n**No premium content showing**\n- Confirm you have active Patreon subscriptions to iOS creators\n- Re-authenticate: `swift-mcp auth patreon`\n- Check Patreon source is enabled: `swift-mcp source list`\n\n### Getting Help\n\n- 📖 [Full Documentation](docs/)\n- 🐛 [Report Issues](https://github.com/efremidze/swift-mcp/issues)\n- 💬 [Discussions](https://github.com/efremidze/swift-mcp/discussions)\n\n## 🗺️ Roadmap\n\n### Current (v1.x)\n- [x] Core MCP server\n- [x] Swift by Sundell RSS\n- [x] Antoine van der Lee RSS\n- [x] Patreon OAuth\n- [ ] Point-Free GitHub\n- [ ] Advanced filtering\n\n### Future (v2.x)\n- [ ] Additional premium sources\n- [ ] More free sources\n- [ ] Advanced search (with vector embeddings)\n- [ ] Code validation\n\n## 🤝 Contributing\n\nWe welcome contributions! See our [contributing guidelines](CONTRIBUTING.md).\n\n## 📄 License\n\nMIT License - Copyright (c) 2026 Lasha Efremidze\n\n## 🙏 Credits\n\n**Created by** [Lasha Efremidze](https://github.com/efremidze)\n\n**Content Sources**\n- [John Sundell](https://swiftbysundell.com) - Swift by Sundell\n- [Antoine van der Lee](https://www.avanderlee.com) - SwiftLee\n- [Point-Free](https://www.pointfree.co) - Advanced Swift education\n\n**Built with** [Model Context Protocol](https://modelcontextprotocol.io)\n\n---\n\n**Made with ❤️ for the Swift community**\n\n[⭐ Star this repo](https://github.com/efremidze/swift-mcp) • [🐛 Report Bug](https://github.com/efremidze/swift-mcp/issues) • [✨ Request Feature](https://github.com/efremidze/swift-mcp/issues)\n","readmeFilename":"README.md"}