███╗   ███╗ ██████╗██████╗  ██████╗ ██╗      ██████╗  ██████╗██╗   ██╗
████╗ ████║██╔════╝██╔══██╗██╔═══██╗██║     ██╔═══██╗██╔════╝╚██╗ ██╔╝
██╔████╔██║██║     ██████╔╝██║   ██║██║     ██║   ██║██║  ███╗╚████╔╝ 
██║╚██╔╝██║██║     ██╔═══╝ ██║   ██║██║     ██║   ██║██║   ██║ ╚██╔╝  
██║ ╚═╝ ██║╚██████╗██║     ╚██████╔╝███████╗╚██████╔╝╚██████╔╝  ██║   
╚═╝     ╚═╝ ╚═════╝╚═╝      ╚═════╝ ╚══════╝ ╚═════╝  ╚═════╝   ╚═╝

1-CLICK DREAM MCP SETUP

The MCP Fast Lane for Vibe Coders
Devs are tolerated on the condition that they strictly don't kill the vibe

📋 Please read the sign at the reception

███████████████████████████████████████████████████████████████████████████████████████████
█                                                                                         █
█  ██████╗ ███████╗██╗   ██╗███████╗                                                    █
█  ██╔══██╗██╔════╝██║   ██║██╔════╝                                                    █
█  ██║  ██║█████╗  ██║   ██║███████╗                                                    █
█  ██║  ██║██╔══╝  ╚██╗ ██╔╝╚════██║                                                    █
█  ██████╔╝███████╗ ╚████╔╝ ███████║                                                    █
█  ╚═════╝ ╚══════╝  ╚═══╝  ╚══════╝                                                    █
█                                                                                         █
█  ██████╗  ██████╗ ███╗   ██╗████████╗                                                 █
█  ██╔══██╗██╔═══██╗████╗  ██║╚══██╔══╝                                                 █
█  ██║  ██║██║   ██║██╔██╗ ██║   ██║       ██╗                                          █
█  ██║  ██║██║   ██║██║╚██╗██║   ██║       ██║                                          █
█  ██████╔╝╚██████╔╝██║ ╚████║   ██║       ██║                                          █
█  ╚═════╝  ╚═════╝ ╚═╝  ╚═══╝   ╚═╝       ╚═╝                                          █
█                                                                                         █
█  ██╗  ██╗██╗██╗     ██╗                                                               █
█  ██║ ██╔╝██║██║     ██║                                                               █
█  █████╔╝ ██║██║     ██║                                                               █
█  ██╔═██╗ ██║██║     ██║                                                               █
█  ██║  ██╗██║███████╗███████╗                                                          █
█  ╚═╝  ╚═╝╚═╝╚══════╝╚══════╝                                                          █
█                                                                                         █
█  ███╗   ███╗██╗   ██╗    ██╗   ██╗██╗██████╗ ███████╗                                █
█  ████╗ ████║╚██╗ ██╔╝    ██║   ██║██║██╔══██╗██╔════╝                                █
█  ██╔████╔██║ ╚████╔╝     ██║   ██║██║██████╔╝█████╗                                  █
█  ██║╚██╔╝██║  ╚██╔╝      ╚██╗ ██╔╝██║██╔══██╗██╔══╝                                  █
█  ██║ ╚═╝ ██║   ██║        ╚████╔╝ ██║██████╔╝███████╗                                █
█  ╚═╝     ╚═╝   ╚═╝         ╚═══╝  ╚═╝╚═════╝ ╚══════╝                                █
█                                                                                         █
███████████████████████████████████████████████████████████████████████████████████████████

██████╗ ███████╗██╗   ██╗███████╗    ██████╗  ██████╗ ███╗   ██╗████████╗
██╔══██╗██╔════╝██║   ██║██╔════╝    ██╔══██╗██╔═══██╗████╗  ██║╚══██╔══╝
██║  ██║█████╗  ██║   ██║███████╗    ██║  ██║██║   ██║██╔██╗ ██║   ██║   
██║  ██║██╔══╝  ╚██╗ ██╔╝╚════██║    ██║  ██║██║   ██║██║╚██╗██║   ██║   
██████╔╝███████╗ ╚████╔╝ ███████║    ██████╔╝╚██████╔╝██║ ╚████║   ██║   
╚═════╝ ╚══════╝  ╚═══╝  ╚══════╝    ╚═════╝  ╚═════╝ ╚═╝  ╚═══╝   ╚═╝   
                                                                           
██╗  ██╗██╗██╗     ██╗         ███╗   ███╗██╗   ██╗    ██╗   ██╗██╗██████╗ ███████╗
██║ ██╔╝██║██║     ██║         ████╗ ████║╚██╗ ██╔╝    ██║   ██║██║██╔══██╗██╔════╝
█████╔╝ ██║██║     ██║         ██╔████╔██║ ╚████╔╝     ██║   ██║██║██████╔╝█████╗  
██╔═██╗ ██║██║     ██║         ██║╚██╔╝██║  ╚██╔╝      ╚██╗ ██╔╝██║██╔══██╗██╔══╝  
██║  ██╗██║███████╗███████╗    ██║ ╚═╝ ██║   ██║        ╚████╔╝ ██║██████╔╝███████╗
╚═╝  ╚═╝╚═╝╚══════╝╚══════╝    ╚═╝     ╚═╝   ╚═╝         ╚═══╝  ╚═╝╚═════╝ ╚══════╝

╔═══════════════════════════════════════════════════════════════════════════════╗
║                                                                               ║
║  ▓█████▄ ▓█████ ██▒   █▓  ██████    ▓█████▄  ▒█████   ███▄    █ ▄▄▄█████▓   ║
║  ▒██▀ ██▌▓█   ▀▓██░   █▒▒██    ▒    ▒██▀ ██▌▒██▒  ██▒ ██ ▀█   █ ▓  ██▒ ▓▒   ║
║  ░██   █▌▒███   ▓██  █▒░░ ▓██▄      ░██   █▌▒██░  ██▒▓██  ▀█ ██▒▒ ▓██░ ▒░   ║
║  ░▓█▄   ▌▒▓█  ▄  ▒██ █░░  ▒   ██▒   ░▓█▄   ▌▒██   ██░▓██▒  ▐▌██▒░ ▓██▓ ░    ║
║  ░▒████▓ ░▒████▒  ▒▀█░  ▒██████▒▒   ░▒████▓ ░ ████▓▒░▒██░   ▓██░  ▒██▒ ░    ║
║   ▒▒▓  ▒ ░░ ▒░ ░  ░ ▐░  ▒ ▒▓▒ ▒ ░    ▒▒▓  ▒ ░ ▒░▒░▒░ ░ ▒░   ▒ ▒   ▒ ░░      ║
║                                                                               ║
║   ██ ▄█▀ ██▓ ██▓     ██▓        ███▄ ▄███▓▓██   ██▓    ██▒   █▓ ██▓ ▄▄▄▄   ▓█████ ║
║   ██▄█▒ ▓██▒▓██▒    ▓██▒       ▓██▒▀█▀ ██▒ ▒██  ██▒   ▓██░   █▒▓██▒▓█████▄ ▓█   ▀ ║
║  ▓███▄░ ▒██▒▒██░    ▒██░       ▓██    ▓██░  ▒██ ██░    ▓██  █▒░▒██▒▒██▒ ▄██▒███   ║
║  ▓██ █▄ ░██░▒██░    ▒██░       ▒██    ▒██   ░ ▐██▓░     ▒██ █░░░██░▒██░█▀  ▒▓█  ▄ ║
║  ▒██▒ █▄░██░░██████▒░██████▒   ▒██▒   ░██▒  ░ ██▒▓░      ▒▀█░  ░██░░▓█  ▀█▓░▒████▒║
║  ▒ ▒▒ ▓▒░▓  ░ ▒░▓  ░░ ▒░▓  ░   ░ ▒░   ░  ░   ██▒▒▒       ░ ▐░  ░▓  ░▒▓███▀▒░░ ▒░ ░║
║                                                                               ║
╚═══════════════════════════════════════════════════════════════════════════════╝

    ____  _______    _______    ____  ____  _   ______________
   / __ \/ ____/ |  / / ___/   / __ \/ __ \/ | / /_  __/ ____/
  / / / / __/  | | / /\__ \   / / / / / / /  |/ / / / / /     
 / /_/ / /___  | |/ /___/ /  / /_/ / /_/ / /|  / / / / /___   
/_____/_____/  |___//____/  /_____/\____/_/ |_/ /_/ /_____/   
                                                               
    __ __ ______    __       __  ____  __   _    _________  ______
   / //_//  _/ /   / /      /  |/  \ \/ /  | |  / /  _/ __ )/ ____/
  / ,<   / // /   / /      / /|_/ / \  /   | | / // // __  / __/   
 / /| |_/ // /___/ /___   / /  / /  / /    | |/ // // /_/ / /___   
/_/ |_/___/_____/_____/  /_/  /_/  /_/     |___/___/_____/_____/   

DEVS DON'T KILL MY VIBE


> SYSTEM MESSAGE: PRIORITY ALPHA
> ==============================
>                                
> ██████  ███████ ██    ██ ███████     
> ██   ██ ██      ██    ██ ██          
> ██   ██ █████   ██    ██ ███████     
> ██   ██ ██       ██  ██       ██     
> ██████  ███████   ████   ███████     
>                                      
> ██████   ██████  ███    ██ ████████  
> ██   ██ ██    ██ ████   ██    ██     
> ██   ██ ██    ██ ██ ██  ██    ██     
> ██   ██ ██    ██ ██  ██ ██    ██     
> ██████   ██████  ██   ████    ██     
>                                      
> ██   ██ ██ ██      ██                
> ██  ██  ██ ██      ██                
> █████   ██ ██      ██                
> ██  ██  ██ ██      ██                
> ██   ██ ██ ███████ ███████           
>                                      
> ███    ███ ██    ██                  
> ████  ████  ██  ██                   
> ██ ████ ██   ████                    
> ██  ██  ██    ██                     
> ██      ██    ██                     
>                                      
> ██    ██ ██ ██████  ███████          
> ██    ██ ██ ██   ██ ██               
> ██    ██ ██ ██████  █████            
>  ██  ██  ██ ██   ██ ██               
>   ████   ██ ██████  ███████          
>                                      
> ==============================
> END TRANSMISSION

✅ The Whitelist

Battle-tested MCPs that actually work. Start here for happiness.

desktop-commander

Tier 1 - essential
Reliability: 100% | Last tested: 2025-06-27

Package: @wonderwhy-er/desktop-commander@latest

Features: Terminal control, file operations, process management

Notes: CRITICAL - DO NOT DISABLE. 'If you cut that wire I am fucked' - The backbone of everything

context7

Tier 1 - essential
Reliability: 100% | Last tested: 2025-06-26

Package: @upstash/context7-mcp@latest

Features: Library documentation, code examples, API references

Notes: Essential for documentation. No schema issues.

github

Tier 2 - working
Reliability: 95% | Last tested: 2025-06-26

Package: ghcr.io/github/github-mcp-server

Features: Full GitHub API access, issue management, PR operations

Notes: Docker image. Occasional startup delays.

🚫 The Blacklist

MCPs that will ruin your day. Learn from our pain.

memory (mcp-memory-service)

INCOMPATIBLE
Added: 2025-06-26 | Version: 0.1.2

Package: npm install mcp-memory-service@0.1.2

Error: Tool 293/318/328 - 'input_schema does not support oneOf, allOf, or anyOf at the top level'

Notes: The Great Double-Dipping Incident™ - Works in Claude Desktop but breaks CLI. Discovered after 45 minutes of debugging at 2 AM. Multiple instances were running as zombie processes causing schema conflicts.

Alternative: Use Notion MCP or other storage solutions

🔬 Replication Steps
1. Install in both claude_desktop_config.json and config.json
2. Run any Claude Code command
3. Watch schema validation errors cascade

@modelcontextprotocol/server-postgres

INCOMPATIBLE
Added: 2025-06-27 | Version: 0.1.0

Package: npm install @modelcontextprotocol/server-postgres@0.1.0

Error: Connection pooling issues with Claude Code CLI

Notes: Crashes on concurrent requests. Pool exhaustion after 10 queries.

Alternative: Use direct SQL queries with desktop-commander

🔬 Replication Steps
Run multiple database queries in quick succession

@modelcontextprotocol/server-everything

INCOMPATIBLE
Added: 2025-06-26 | Version: 0.5.0

Package: npm install @modelcontextprotocol/server-everything@0.5.0

Error: Tool 293 - schema validation failure

Notes: The pain of existence - loads 300+ tools with schema issues

Alternative: Use specific MCPs for needed functionality

🔬 Replication Steps
Just add to config and cry

@modelcontextprotocol/server-time

DEAD
Added: 2025-06-26 | Version: N/A

Package: npm install @modelcontextprotocol/server-time

Error: NPM 404 - Package doesn't exist

Notes: DOES NOT EXIST IN REGISTRY

Alternative: Use system date command

🔬 Replication Steps
Try to install it. 404 every time.

@modelcontextprotocol/server-brave-search

DEAD
Added: 2025-06-26 | Version: 0.1.0

Package: npm install @modelcontextprotocol/server-brave-search@0.1.0

Error: Failed to initialize

Notes: Non-functional or missing dependencies

Alternative: Use perplexity or web search

🔬 Replication Steps
Install and watch it fail silently

brave-search-mcp@latest

INCOMPATIBLE
Added: 2025-06-26 | Version: latest

Package: npm install brave-search-mcp@latest

Error: Connection issues and potential schema problems

Notes: Known issues with Claude Desktop/Code

Alternative: Use perplexity or web search

🔬 Replication Steps
Add to config, connection timeouts ensue

@ibraheem4/linear-mcp

INCOMPATIBLE
Added: 2025-06-26 | Version: 1.0.0

Package: npm install @ibraheem4/linear-mcp@1.0.0

Error: input_schema does not support oneOf, allOf, or anyOf at the top level

Notes: Schema incompatibility

Alternative: Use official Linear remote MCP: mcp.linear.app/sse

🔬 Replication Steps
Add to config, get schema errors on any Linear command

🍸 Our Favorite Recipes

Curated MCP combinations for specific use cases.

The Developer's Daily

My go-to setup for everyday coding

{
  "desktop-commander": "Always on",
  "context7": "For docs",
  "github": "For repos",
  "playwright": "For testing"
}

Use Case: General development work

The Debugging Special

When shit hits the fan at 2 AM

{
  "desktop-commander": "Core functionality",
  "context7": "Emergency docs"
}

Use Case: Minimal setup to isolate MCP issues

📖 The Memory MCP Double-Dipping Incident

Date: June 26, 2025, 2:00 AM PDT

Duration: 45 minutes of pure debugging hell

The Story:

Picture this: You're ready to deploy your revolutionary codebase after a YEAR of development. Claude Code CLI throws a schema error on EVERY command. You systematically debug, remove MCPs one by one, even use binary search. Nothing works.

The plot twist? Memory MCP was "double-dipping" - running in BOTH config files AND as zombie processes from previous sessions. The tool numbers kept changing (293→318→328) because of different load orders. It took 45 minutes to discover memory MCP was the culprit.

Lesson: Always check ALL config files, kill zombie processes, and remember: "disabled" doesn't mean "not running."