From bc1d0ace8292a1297eec3799cd984e802f8f4718 Mon Sep 17 00:00:00 2001
From: kazuki <kazuki@kazukinoMacBook-Air.local>
Date: Sun, 19 Oct 2025 22:38:25 +0900
Subject: [PATCH] docs: update README to emphasize MCP-optional design with
 performance benefits

- Clarify SuperClaude works fully without MCPs
- Add 'Minimal Setup' section (no MCPs required)
- Add 'Recommended Setup' section with performance benefits
- Highlight: 2-3x faster, 30-50% fewer tokens with MCPs
- Reference MCP integration documentation

Aligns with MCP optional design philosophy:
- MCPs enhance performance, not functionality
- Users choose their enhancement level
- Zero barriers to entry
---
 README.md | 23 ++++++++++++++++++++++-
 1 file changed, 22 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index c415e66..0e8bda8 100644
--- a/README.md
+++ b/README.md
@@ -100,7 +100,9 @@ Claude Code is a product built and maintained by [Anthropic](https://www.anthrop
 
 ## ⚡ **Quick Installation**
 
-### **Choose Your Installation Method**
+### **Minimal Setup - Works Immediately (No MCPs Required)**
+
+SuperClaude works **fully functional** without any MCP servers. Install and start using immediately:
 
 | Method | Command | Best For |
 |:------:|---------|----------|
@@ -108,6 +110,25 @@ Claude Code is a product built and maintained by [Anthropic](https://www.anthrop
 | **📦 pip** | `pip install SuperClaude && pip upgrade SuperClaude && SuperClaude install` | Traditional Python environments |
 | **🌐 npm** | `npm install -g @bifrost_inc/superclaude && superclaude install` | Cross-platform, Node.js users |
 
+### **Recommended Setup - Enhanced Performance (Optional MCPs)**
+
+For **2-3x faster** execution and **30-50% fewer tokens**, optionally install MCP servers:
+
+```bash
+# After basic installation, enhance with MCP servers:
+# - Mindbase: Cross-session memory (automatic)
+# - Serena: Faster code understanding (2-3x faster)
+# - Sequential: Token-efficient reasoning (30-50% fewer tokens)
+# - Context7: Curated official documentation
+# - Tavily: Optimized web search
+
+# See docs/mcp/mcp-integration-policy.md for MCP installation guides
+```
+
+**Performance Comparison:**
+- **Without MCPs**: Fully functional, standard performance ✅
+- **With MCPs**: 2-3x faster, 30-50% fewer tokens ⚡
+
 </div>
 
 <details>