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|中文

A fully upgraded MCP server providing SuperClaude Framework v4.0.8 compatibility for Gemini CLI. Features enhanced command routing with 21 specialized /sc: commands, 14 domain-expert agents, and 6 integrated MCP servers.

🚀 What's New in v2.0.0 (SuperClaude v4.0.8 Upgrade)

🧠 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.
📋 21 Specialized Commands: All commands now use the /sc: namespace to prevent conflicts.
⚡ 5 Behavioral Modes: Brainstorming, Introspection, Orchestration, Task Management, and Token Efficiency modes.
💾 Cross-Session Persistence: sc:load and sc:save commands 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

21 Core Commands with /sc: namespace for SuperClaude Framework v4.0.8 compliance:

Development & Orchestration

sc:build, sc:implement, sc:workflow, sc:design

Analysis & Discovery

sc:analyze, sc:brainstorm, sc:troubleshoot, sc:estimate

Quality & Maintenance

sc:improve, sc:test, sc:cleanup, sc:git

Knowledge & Documentation

sc:explain, sc:document

Operations & Session

sc:task, sc:spawn, sc:load, sc:save, sc:reflect

Meta & Discovery

sc:index, sc:select-tool

📊 Architecture (v4.0.8)

┌────────────────────────────────────────——————————————————─┐
│                      Gemini CLI                           │
├────────────────────────────────────────——————————————————─┤
│          Gemini SuperClaude MCP Server v2.0.0             │
├────────────────────────────────────────——————————————————─┤
│        ┌─────────────┐          ┌─────────────────┐       │
│        │ Enhanced    │          │   14-Agent      │       │
│        │ Routing     │          │   System        │       │
│        └─────────────┘          └─────────────────┘       │
├────────────────────────────────────────——————————————————─┤
│           MCP Orchestration Layer (6 Servers)             │
│┌─────────┐┌──────┐┌──────┐┌──────┐┌────┐┌────————┐│┌───———┐
││Sequential││Context7││Magic││Playwright││Morphllm││Serena││
│└─────────┘└──────┘└──────┘└──────┘└────┘└──————──┘│└───——─┘
├───────────────────────────────────────——————————————————──┤
│             SuperClaude Framework v4.0.8                  │
└───────────────────────────────────────——————————————————──┘

🤝 Contributing

PRs are welcome! Please fork the repository, create a feature branch, and open a pull request.

📄 License

MIT License - see the LICENSE file for details.