Swift-patterns-mcp

Provides up-to-date Swift and SwiftUI patterns from trusted educators via an MCP-compatible server.

typescript

0

GitHub Stars

typescript

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "efremidze-swift-patterns-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "swift-patterns-mcp@latest"
      ]
    }
  }
}

You run a dedicated MCP server that aggregates high-quality Swift and SwiftUI patterns from trusted educators, making them easily searchable and explorable by your AI assistant. It keeps content up to date, supports optional premium sources, and provides practical, ready-to-use examples for your Swift development workflows.

How to use

You connect an MCP client to the server to ask for patterns, examples, and best practices. Start by installing and configuring the MCP client, then use natural language queries to find specific SwiftUI animation techniques, navigation patterns, MVVM guidance, or testing insights. Your client will search enabled sources, apply quality filtering, fetch content, and present concise, usable results with code snippets when available.

How to install

Prerequisites: you need Node.js version 18.0.0 or higher.

Install the MCP server client globally.

npm install -g swift-patterns-mcp

Configure your MCP client. The server uses a standard stdio (local) runtime. The run command shown here uses npx to launch the MCP server client.

command: npx
args: ["-y", "swift-patterns-mcp@latest"]

If your client supports direct MCP configuration files, add the following stdio entry to your project configuration to start the server.

{
  "mcpServers": {
    "swift_patterns": {
      "command": "npx",
      "args": ["-y", "swift-patterns-mcp@latest"]
    }
  }
}

Additional sections

Configuration, security, and usage tips help you get the most from the server. You can enable or disable content sources, adjust quality thresholds, and optionally connect premium sources if you have Patreon access.

Configuration

The server config enables free sources by default and can be adjusted to raise quality thresholds or enable Patreon-rich content. A representative configuration includes enabling free sources and setting a reasonable quality filter.

{
  "sources": {
    "sundell": { "enabled": true, "quality": 60 },
    "vanderlee": { "enabled": true, "quality": 60 },
    "pointfree": { "enabled": false, "quality": 60 },
    "patreon": { "enabled": false }
  },
  "cache": {
    "ttl": 86400
  }
}

Troubleshooting

If you encounter issues, verify your Node version, check that the MCP server is reachable, and confirm that the configured sources are enabled. Common checks include ensuring the Node runtime is compatible and that the MCP client configuration points to the correct server setup.

Available tools

Patreon integration

Premium access to content from creators via Patreon, enabling enhanced search and content extraction when configured.

Source management

Enable or disable individual content sources (e.g., Sundell, van der Lee, Point-Free) and adjust per-source quality thresholds.

Setup and authentication

Configure MCP clients, authorize Patreon access if used, and manage per-client authentication flows.