Skip to main content
Glama
tinywind

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 18 or higher

  • Gemini CLI installed

Related MCP server: Gemini MCP Server for Claude Code

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 (18+)

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

A
license - permissive license
-
quality - not tested
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/tinywind/superclaude-gemini-integration-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server