Skip to main content
Glama
SuperClaude MCP Server

SuperClaude MCP Server

by tinywind

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.js

Method 2: Global Installation

# Global install
npm install -g .

# Or use npm link
npm link

Gemini 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 listed

2. 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 projects

  • sc_dev-setup - Set up development environment

  • sc_test - Create and run tests

  • sc_analyze - Analyze code

  • sc_troubleshoot - Troubleshoot issues

  • sc_improve - Improve code

  • sc_explain - Explain code

  • sc_deploy - Automate deployment

  • sc_migrate - Handle migrations

  • sc_scan - Security scanning

  • sc_estimate - Project estimation

  • sc_cleanup - Clean up code

  • sc_git - Git operations

  • sc_design - System design

  • sc_spawn - Create specialized agents

  • sc_document - Generate documentation

  • sc_load - Load configurations

Utility Tools

  • sc_persona - Switch personas

  • sc_checkpoint - Manage Git checkpoints

  • sc_token_mode - Set token optimization

Personas

Available personas:

  • architect - System Architect

  • frontend - Frontend Engineer

  • backend - Backend Engineer

  • security - Security Engineer

  • qa - 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 tasks

Setting 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

  1. Restart Gemini CLI

  2. Check configuration file path

  3. Verify Node.js version (20+)

Commands Not Working

  1. Verify SuperClaude installation: ls ~/.claude

  2. Check logs: gemini --verbose

  3. Check MCP server status: /mcp command

Personas Not Loading

  1. Check persona file: ~/.claude/shared/superclaude-personas.yml

  2. Default personas will be used

  3. Try manually switching personas

Contributing

Issues and PRs are always welcome!

License

MIT License

Available Tools

20 tools
sc_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

    C2.8/5.0

    Scored across 20 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count4/5

    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.

    Completeness5/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers