SuperClaude MCP Server
An MCP server that exposes SuperClaude commands and utilities to Gemini CLI.
Run project commands: build, dev setup, test, analyze, troubleshoot, improve, explain, deploy, migrate, scan, estimate, cleanup, git, design, spawn agents, document, and load configs.
Pass command arguments, command-specific flags, persona selection, and evidence-based methodology data.
Switch active personas: architect, frontend, backend, security, QA.
Create, restore, and list git checkpoints.
Set token optimization modes: normal, compressed, ultracompressed.
Provides Git operations such as creating checkpoints and managing version control tasks through the SuperClaude toolkit.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@SuperClaude MCP Server Switch to architect persona"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
SuperClaude MCP Server
An MCP server that brings all SuperClaude features to Gemini CLI.
Prerequisites
SuperClaude must already be installed in Claude Code
Node.js 20 or higher
Gemini CLI installed
Related MCP server: Gemini SuperClaude MCP Server
Installation
Method 1: Local Installation
# Create project directory
mkdir superclaude-mcp && cd superclaude-mcp
# Copy files (save the code above)
# - superclaude-mcp-server.js
# - package.json
# Install dependencies
npm install
# Grant execution permissions
chmod +x superclaude-mcp-server.jsMethod 2: Global Installation
# Global install
npm install -g .
# Or use npm link
npm linkGemini CLI Configuration
Add the following to your ~/.gemini/settings.json file:
{
"mcpServers": {
"superclaude": {
"command": "node",
"args": ["/path/to/superclaude-mcp-server.js"],
"env": {
"CLAUDE_CONFIG_DIR": "${HOME}/.claude"
}
}
}
}Or configure using npx:
{
"mcpServers": {
"superclaude": {
"command": "npx",
"args": ["-y", "superclaude-gemini-integration-mcp"],
"env": {
"CLAUDE_CONFIG_DIR": "${HOME}/.claude"
}
}
}
}Usage
1. Verify MCP Server
gemini
# In Gemini CLI
/mcp
# Check if superclaude server is listed2. Using SuperClaude Commands
# Build project
gemini "Use sc_build to create a React app with TDD setup"
# Switch persona
gemini "Switch to architect persona using sc_persona"
# Analyze code
gemini "Run sc_analyze on the current codebase with deep analysis"
# Troubleshoot
gemini "Use sc_troubleshoot to debug the API connection issue"
# Create checkpoint
gemini "Create a git checkpoint named 'before-refactor'"3. Using Flags and Options
# Include flags
gemini "Use sc_build with react type and flags --tdd --magic"
# Use with persona
gemini "Use sc_analyze with security persona for vulnerability scanning"
# Evidence-based approach
gemini "Use sc_design with evidence for new authentication system"4. Token Optimization
# Set ultra-compressed mode
gemini "Set token mode to ultracompressed"
# All subsequent responses will be compressed
gemini "Build a complex microservices architecture"Available Tools
Command Tools (sc_*)
sc_build- Build projectssc_dev-setup- Set up development environmentsc_test- Create and run testssc_analyze- Analyze codesc_troubleshoot- Troubleshoot issuessc_improve- Improve codesc_explain- Explain codesc_deploy- Automate deploymentsc_migrate- Handle migrationssc_scan- Security scanningsc_estimate- Project estimationsc_cleanup- Clean up codesc_git- Git operationssc_design- System designsc_spawn- Create specialized agentssc_document- Generate documentationsc_load- Load configurations
Utility Tools
sc_persona- Switch personassc_checkpoint- Manage Git checkpointssc_token_mode- Set token optimization
Personas
Available personas:
architect- System Architectfrontend- Frontend Engineerbackend- Backend Engineersecurity- Security Engineerqa- QA Engineer
Advanced Usage
Using with GEMINI.md
Create a GEMINI.md file in your project root:
# SuperClaude Commands
## Shortcuts
- "sc:build" → Execute sc_build tool
- "sc:analyze" → Execute sc_analyze tool
- "sc:persona [name]" → Switch persona
## Default Persona
Activate architect persona at project start
## Token Mode
Automatically use compressed mode for complex tasksSetting Up Shell Aliases
Add to your .bashrc or .zshrc:
# SuperClaude shortcuts
alias gsc='gemini "Execute SuperClaude command"'
alias gsc-build='gemini "Use sc_build to"'
alias gsc-analyze='gemini "Use sc_analyze on"'
alias gsc-persona='gemini "Switch to persona"'Usage examples:
gsc-build "create a Next.js app with TypeScript"
gsc-analyze "the authentication module"
gsc-persona "security for threat modeling"Troubleshooting
MCP Server Not Visible
Restart Gemini CLI
Check configuration file path
Verify Node.js version (20+)
Commands Not Working
Verify SuperClaude installation:
ls ~/.claudeCheck logs:
gemini --verboseCheck MCP server status:
/mcpcommand
Personas Not Loading
Check persona file:
~/.claude/shared/superclaude-personas.ymlDefault personas will be used
Try manually switching personas
Contributing
Issues and PRs are always welcome!
License
MIT License
Available Tools
20 toolssc_analyzeC
Code analysis - Multi-dimensional analysis of code quality
Inputs: args (required), flags, persona, evidence.
sc_buildD
Universal project builder - Create any type of project with intelligent defaults
Inputs: args (required), flags, persona, evidence.
sc_checkpointC
Create or restore git checkpoint
Inputs: action (required), name.
sc_cleanupC
Code cleanup - Remove technical debt
Inputs: args (required), flags, persona, evidence.
sc_deployD
Deployment automation - Handle deployment workflows
Inputs: args (required), flags, persona, evidence.
sc_designD
System design - Architecture and design patterns
Inputs: args (required), flags, persona, evidence.
sc_dev-setupC
Development environment setup - Configure complete dev environment
Inputs: args (required), flags, persona, evidence.
sc_documentC
Documentation generation - Create comprehensive docs
Inputs: args (required), flags, persona, evidence.
sc_estimateC
Project estimation - Time and resource estimates
Inputs: args (required), flags, persona, evidence.
sc_explainC
Code explanation - Detailed documentation and understanding
Inputs: args (required), flags, persona, evidence.
sc_gitD
Git operations - Advanced git workflows
Inputs: args (required), flags, persona, evidence.
sc_improveD
Code improvement - Enhance existing code
Inputs: args (required), flags, persona, evidence.
sc_loadC
Load configurations - Apply saved configurations
Inputs: args (required), flags, persona, evidence.
sc_migrateD
Migration assistance - Database and code migrations
Inputs: args (required), flags, persona, evidence.
sc_personaB
Switch active SuperClaude persona
Inputs: name (required).
sc_scanC
Security scanning - Comprehensive security analysis
Inputs: args (required), flags, persona, evidence.
sc_spawnC
Create specialized agents - Spawn task-specific AI agents
Inputs: args (required), flags, persona, evidence.
sc_testC
Testing framework - Create and run tests with coverage
Inputs: args (required), flags, persona, evidence.
sc_token_modeC
Set token optimization mode
Inputs: mode (required).
sc_troubleshootC
Intelligent debugging - Systematic issue resolution
Inputs: args (required), flags, persona, evidence.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 20 tools
Most tools have clear, distinct purposes, but there is some overlap between sc_analyze, sc_improve, sc_cleanup, and sc_troubleshoot, which all deal with code modification. However, their descriptions specify different focuses (analysis, enhancement, cleanup, debugging), so an agent can usually select the right one.
All tools consistently use the sc_ prefix with lowercase hyphenated names (e.g., sc_dev-setup, sc_analyze). This uniform pattern makes the tool naming highly predictable and easy to navigate.
With 20 tools, the set is slightly above the ideal 3-15 range, but each tool serves a distinct development function, from building to deployment. The count feels comprehensive rather than bloated for an all-in-one development assistant.
The tool surface covers the entire development lifecycle—project creation, setup, testing, analysis, debugging, improvement, deployment, migration, security, estimation, documentation, and git operations. There are no obvious gaps that would force an agent into a dead end for common workflows.
Maintenance
Related MCP Connectors
Source-checked CLI guides and model-aware planning for Claude Code, Codex, and Grok Build.
Work on your own computers from Claude or ChatGPT: run commands, edit and search files.
Agent personas for Claude. 16 tools, 13 personas, 3 workflows. Zero extra API cost. Free.
Persistent memory for Claude Code and Cursor. Stop re-explaining your project every session.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables Claude Code to consult Gemini for complex coding problems with session management, file attachments, and conversation persistence.106MIT
- AlicenseCqualityDmaintenanceEnhances Gemini CLI with SuperClaude Framework v4.0.9, providing 22 specialized commands, 14 domain-expert agents, and integration with 6 MCP servers for development, analysis, and automation.2288 npm39MIT
- AlicenseBqualityDmaintenanceEnables Claude to offload large codebase analysis to Google Gemini with 1M+ token context windows, persistent sessions, and dramatic token savings.867 npm1MIT
- AlicenseAqualityDmaintenanceIntegrates the local gemini CLI tool with Claude Code, allowing Claude to execute Gemini AI queries via the MCP protocol.11MIT