enable_source
Enable a content source (requires setup for premium sources)
LABSCO SUMMARY
Four Swift blogs, indexed and searchable, with memory that outlives the session.
The value here is retrieval quality rather than volume: a small set of trusted educators, a quality filter on what gets indexed, and a store that keeps what you already looked up. The premium half is genuinely optional — the free sources work with no credentials at all, and Patreon only matters if you already support the creators it reaches.
What it is
An MCP server over a curated body of Swift and SwiftUI writing. It fetches, caches, and indexes four public sources, keeps what it finds in a single-file store so recall survives a restart, and can reach Patreon creators once OAuth is set up.
What you get
- get_swift_pattern — reference patterns from the free sources, narrowed by topic, by source, or by a minimum quality score
- search_swift_content — one natural-language search across every enabled source, with an option to require code in the results
- list_content_sources — which sources exist and which are currently on
- enable_source — turn a source on, premium ones included once they are configured
- Persistent memory in ~/.swift-patterns-mcp/swift-patterns-memory.mv2, so a pattern found last session is still findable after a restart
- Semantic recall as an opt-in fallback when keyword scores come in low, with a configurable activation threshold
- Auto-refreshing content from RSS feeds and GitHub, so the index tracks what the sources publish
Requirements
Node.js 18.0.0 or higher. Clients run npx -y swift-patterns-mcp@latest; the same command opens a setup wizard when you run it in an interactive terminal, and the wizard can write the config for Cursor, Claude Code, Windsurf, or VS Code. Nothing else is needed for the four free sources. Configuration lands at ~/.swift-patterns-mcp/config.json. Patreon content needs PATREON_CLIENT_ID and PATREON_CLIENT_SECRET, and YOUTUBE_API_KEY adds video search from those creators. Semantic recall downloads a transformer model the first time it runs.
Setup effort
One command — npx -y swift-patterns-mcp@latest
USE CASES
01
Answering a SwiftUI how-to without opening a browser
Search every enabled source in one call and get back the passage that answers it.
02
Comparing two architecture approaches before committing
Pull reference patterns per topic, then widen to a natural-language search when the topic name is not the term the authors used.
03
Getting examples that come with real code
Search with the require-code option so prose-only articles drop out of the results.
04
Checking what the server can actually reach right now
List the sources with their status, then switch on the one you expected to be answering.
4 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
get_swift_pattern
Get Swift/SwiftUI reference patterns from curated free sources (Sundell, van der Lee, Nil Coalescing, Point-Free). Best for conceptual guidance and free-source examples.
list_content_sources
List all available content sources and their status
search_swift_content
Unified search across all enabled sources (free + premium). Use this for broad natural-language queries. When Patreon is enabled, includes premium creator posts and downloadable code.
BEFORE YOU INSTALL
What to know first
Tools you get
4 tools when we connected. The patreon source is disabled until its OAuth wizard runs; enable_source and list_content_sources let an agent check and change sources.
Requires
- npx on PATH
- Node.js 18.0.0 or later
CONTEXT COST
Light Standing cost
Rated by the size of the 4 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
npx -y swift-patterns-mcp@latestMCP Clients
Cursor, Claude Code, Windsurf
JSON
{
"mcpServers": {
"swift-patterns": {
"command": "npx",
"args": [
"-y",
"swift-patterns-mcp@latest"
]
}
}
}VS Code
VS CODE · JSON
{
"servers": {
"swift-patterns": {
"command": "npx",
"args": [
"-y",
"swift-patterns-mcp@latest"
]
}
}
}All clients — setup wizard
ALL CLIENTS — SETUP WIZARD · TERMINAL
npx -y swift-patterns-mcp@latest setup --all --global
