Package Exports
- gemini-superclaude-mcp-server
- gemini-superclaude-mcp-server/superclaude-server.js
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (gemini-superclaude-mcp-server) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
Gemini SuperClaude MCP Server
English|中文
GEMINI_CLI_COMMANDS
A fully upgraded MCP server providing SuperClaude Framework v4.0.9 compatibility for Gemini CLI. Features enhanced command routing with 22 specialized /sc: commands (including new business-panel), 14 domain-expert agents, and 6 integrated MCP servers plus full Gemini CLI integration via TOML commands.
🚀 What's New in v2.0.2 (SuperClaude v4.0.9 Upgrade)
- 💼 NEW: Business Panel: Multi-expert business analysis with 9 thought leaders (Christensen, Porter, Drucker, Godin, Kim & Mauborgne, Collins, Taleb, Meadows, Doumont)
- 🎯 Gemini CLI Integration: All 22 commands available as
/sc:commandin Gemini CLI via TOML configuration - 📦 Auto Installation:
npm run install-commandsfor seamless Gemini CLI integration - 🧠 Enhanced Routing: Intelligent context analysis, agent selection, and MCP server coordination.
- 🤖 14 Specialized Agents: Replaces the old persona system with domain experts for architecture, security, performance, etc.
- 🔗 6 MCP Servers: Full integration with Sequential, Context7, Magic, Playwright, Morphllm, and Serena.
- 📋 22 Specialized Commands: All commands now use the
/sc:namespace with business panel added. - ⚡ 5 Behavioral Modes: Brainstorming, Introspection, Orchestration, Task Management, and Token Efficiency modes.
- 💾 Cross-Session Persistence:
sc:loadandsc:savecommands powered by the Serena MCP for session memory.
🔧 Quick Start
Method 1: NPM Package (Recommended)
# Install globally
npm install -g gemini-superclaude-mcp-server
# Configure Gemini CLI (~/.gemini/settings.json)
{
"mcpServers": {
"superclaude": {
"command": "npx",
"args": ["-y", "gemini-superclaude-mcp-server"],
"env": {
"CLAUDE_CONFIG_DIR": "${HOME}/.claude"
}
}
}
}Method 2: Local Development
# Clone and setup
git clone https://github.com/Dianel555/gemini-superclaude-mcp-server.git
cd gemini-superclaude-mcp-server
npm install
# Make script executable
chmod +x superclaude-server.js
# Configure Gemini CLI (~/.gemini/settings.json)
{
"mcpServers": {
"superclaude": {
"command": "node",
"args": ["/full/path/to/superclaude-server.js"],
"env": {
"CLAUDE_CONFIG_DIR": "${HOME}/.claude"
}
}
}
}
# Validate and test
npm run validate
npm test🤖 Enhanced Agent System (Formerly Personas)
14 Specialized Agents provide domain expertise for any task:
| Agent | Focus | Thinking Mode | Auto-Triggers | Specialization |
|---|---|---|---|---|
| system-architect | System design | Systematic | architecture, design, scalability | sc:build, sc:analyze |
| frontend-architect | User experience | User-centric | ui, component, responsive | sc:build, sc:implement |
| backend-architect | Data integrity | Data-driven | api, database, service | sc:implement, sc:troubleshoot |
| devops-architect | Automation & CI/CD | Automation-focused | deploy, infrastructure, ci/cd | sc:workflow, sc:git |
| security-engineer | Threat modeling | Threat-focused | security, vulnerability, auth | sc:analyze, sc:improve |
| performance-engineer | Optimization | Measurement-driven | optimize, performance, bottleneck | sc:analyze, sc:improve |
| quality-engineer | Testing strategy | Systematic-validation | test, quality, validation | sc:test, sc:troubleshoot |
| refactoring-expert | Code quality | Simplification-focused | refactor, cleanup, debt | sc:improve, sc:cleanup |
| root-cause-analyst | Problem investigation | Investigative | debug, investigate, analyze | sc:analyze, sc:troubleshoot |
| requirements-analyst | Requirements discovery | Discovery-focused | requirements, scope, planning | sc:brainstorm, sc:estimate |
| python-expert | Python architecture | Pythonic-focused | python, django, flask | sc:implement, sc:improve |
| socratic-mentor | Knowledge transfer | Educational | learn, explain, understand | sc:explain, sc:document |
| learning-guide | Concept simplification | Pedagogical | tutorial, beginner, example | sc:explain, sc:document |
| technical-writer | Documentation | Communication-focused | document, readme, guide | sc:document, sc:save |
🔗 Real MCP Integration
6 Supported Servers
- Sequential: Complex multi-step reasoning
- Context7: Documentation and pattern lookup
- Magic: UI component generation
- Playwright: E2E testing and browser automation
- Morphllm: Pattern-based code editing and bulk transformations
- Serena: Semantic code understanding and cross-session memory
📋 Complete Command Set
22 Core Commands with /sc: namespace for SuperClaude Framework v4.0.9 compliance:
Development & Orchestration
sc:build,sc:implement,sc:workflow,sc:design
Analysis & Discovery
sc:analyze,sc:brainstorm,sc:troubleshoot,sc:business-panel,sc:estimate
Quality & Maintenance
sc:improve,sc:test,sc:cleanup,sc:git
Documentation & Learning
sc:explain,sc:document
Operations & Coordination
sc:task,sc:spawn,sc:load,sc:save,sc:reflect
Meta & Discovery
sc:index,sc:select-tool
🎯 Gemini CLI Integration
Install SuperClaude commands directly in Gemini CLI:
# Install all 22 commands as /sc: shortcuts
npm run install-commands
# Use in Gemini CLI
/sc:analyze --security --deep
/sc:business-panel strategy.md --experts porter,taleb --mode debate
/sc:build ecommerce --framework nextjs --magic
# Uninstall if needed
npm run uninstall-commandsBusiness Panel (New in v4.0.9)
Multi-expert business analysis with 9 thought leaders:
- Clayton Christensen: Disruption Theory, Jobs-to-be-Done
- Michael Porter: Competitive Strategy, Five Forces
- Peter Drucker: Management Philosophy, MBO
- Seth Godin: Marketing Innovation, Tribe Building
- Kim & Mauborgne: Blue Ocean Strategy
- Jim Collins: Organizational Excellence
- Nassim Taleb: Risk Management, Antifragility
- Donella Meadows: Systems Thinking
- Jean-luc Doumont: Communication Systems
📊 Architecture (v4.0.9)
┌────────────────────────────────────────────────────────────┐
│ Gemini CLI │
│ ┌─────────────────────────────────────┐ │
│ │ 22 /sc: Commands via TOML │ │
│ └─────────────────────────────────────┘ │
├────────────────────────────────────────────────────────────┤
│ Gemini SuperClaude MCP Server v2.0.2 │
│ ┌─────────────┐ ┌─────────────────┐ ┌─────────────┐ │
│ │ Enhanced │ │ 14-Agent │ │ Business │ │
│ │ Routing │ │ System │ │ Panel (9) │ │
│ └─────────────┘ └─────────────────┘ └─────────────┘ │
├────────────────────────────────────────────────────────────┤
│ MCP Orchestration Layer (6 Servers) │
│ ┌─────────┐┌────────┐┌─────┐┌──────────┐┌────────┐┌──────┐ │
│ │Sequentia││Context7││Magic││Playwright││Morphllm││Serena│ │
│ └─────────┘└────────┘└─────┘└──────────┘└────────┘└──────┘ │
├────────────────────────────────────────────────────────────┤
│ SuperClaude Framework v4.0.9 │
└────────────────────────────────────────────────────────────┘🤝 Contributing
PRs are welcome! Please fork the repository, create a feature branch, and open a pull request.
🙏 Acknowledgments
- Thanks for SuperClaude_Framework.
- Original tinywind/superclaude-gemini-integration-mcp for the foundation
- MCP community for the protocol standards
📄 License
MIT License - see the LICENSE file for details.