Gemini Superclaude
A **complete rewrite** of the original SuperClaude MCP server with intelligent command routing, dynamic persona switching, and real MCP server orchestration for Gemini CLI.Th
What is Gemini Superclaude?
Gemini Superclaude is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to **complete rewrite** of the original superclaude mcp server with intelligent command routing, dynamic persona switching, and real mcp server orchestration for gemini cli.th
A **complete rewrite** of the original SuperClaude MCP server with intelligent command routing, dynamic persona switching, and real MCP server orchestration for Gemini CLI.Th
This server falls under the Coding Agents category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A **complete rewrite** of the original SuperClaude MCP serve
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx gemini-superclaudeConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Gemini Superclaude
Gemini SuperClaude MCP Server is a complete rewrite of the SuperClaude framework (v4.0.9) adapted as an MCP server for Gemini CLI, providing 22 specialized /sc: commands, 14 domain-expert agents, and orchestration across 6 integrated MCP servers (Sequential, Context7, Magic, Playwright, Morphllm, and Serena). It adds intelligent command routing, dynamic agent selection based on context, a business analysis panel with 9 thought-leader frameworks, and cross-session memory via the Serena MCP. Developers using Gemini CLI use it to access structured, expert-driven coding, analysis, documentation, and orchestration workflows through a unified command namespace.
Prerequisites
- Node.js 18.0.0 or higher installed
- Gemini CLI installed and configured (see https://github.com/google-gemini/gemini-cli)
- npm or npx available
- Optionally: Claude Code installed (for CLAUDE_CONFIG_DIR integration)
- An MCP-compatible client — the server is designed for Gemini CLI's settings.json
Install the package globally via npm
Install gemini-superclaude-mcp-server globally so it is available as a command.
npm install -g gemini-superclaude-mcp-serverInstall TOML commands into Gemini CLI
Run the install-commands script to register all 22 /sc: commands as Gemini CLI shortcuts. Run this from the global npm installation directory for the package.
# Find the global npm prefix:
npm root -g
# Then navigate to the package and run:
npm run install-commandsConfigure Gemini CLI to use the MCP server
Add the server to your Gemini CLI settings at ~/.gemini/settings.json. Set CLAUDE_CONFIG_DIR if you want integration with your Claude Code configuration.
{
"mcpServers": {
"superclaude": {
"command": "npx",
"args": ["-y", "gemini-superclaude-mcp-server"],
"env": {
"CLAUDE_CONFIG_DIR": "${HOME}/.claude"
}
}
}
}Validate the installation
Run the built-in validation and test scripts to confirm the server is working correctly.
npm run validate
npm testUse /sc: commands in Gemini CLI
Once installed and configured, all 22 SuperClaude commands are available as /sc: shortcuts in Gemini CLI. The server routes each command to the appropriate agent and MCP servers automatically.
# Example commands in Gemini CLI:
/sc:analyze --security --deep
/sc:build ecommerce --framework nextjs --magic
/sc:business-panel strategy.md --experts porter,taleb --mode debateGemini Superclaude Examples
Client configuration
Gemini CLI ~/.gemini/settings.json configuration for the gemini-superclaude-mcp-server using npx.
{
"mcpServers": {
"superclaude": {
"command": "npx",
"args": ["-y", "gemini-superclaude-mcp-server"],
"env": {
"CLAUDE_CONFIG_DIR": "${HOME}/.claude"
}
}
}
}Prompts to try
These /sc: commands work in Gemini CLI after installing TOML commands. Each routes to the appropriate domain-expert agent.
- "/sc:analyze --security --deep" (routes to security-engineer agent)
- "/sc:build ecommerce --framework nextjs --magic" (routes to frontend-architect + Magic MCP)
- "/sc:troubleshoot --investigate" (routes to root-cause-analyst agent)
- "/sc:business-panel strategy.md --experts porter,christensen" (9-expert business analysis)
- "/sc:document --api --readme" (routes to technical-writer agent)
- "/sc:test --coverage --e2e" (routes to quality-engineer + Playwright MCP)
- "/sc:save" (persists session memory via Serena MCP for cross-session continuity)Troubleshooting Gemini Superclaude
/sc: commands not recognized in Gemini CLI after installation
Run `npm run install-commands` from inside the globally installed package directory (find it with `npm root -g`). The TOML command files must be copied to Gemini CLI's command directory. Restart Gemini CLI after running the install script.
MCP server fails to start with Node version error
The package requires Node.js 18.0.0 or higher. Check your version with `node --version` and upgrade if needed using nvm: `nvm install 18 && nvm use 18`.
Integrated MCP servers (Context7, Magic, Playwright, etc.) are not working
The 6 integrated MCP servers (Sequential, Context7, Magic, Playwright, Morphllm, Serena) must be independently installed and registered in your Gemini CLI or MCP client config. Gemini SuperClaude orchestrates them but does not install them. Install each separately following their own documentation and add them to your settings.json.
Frequently Asked Questions about Gemini Superclaude
What is Gemini Superclaude?
Gemini Superclaude is a Model Context Protocol (MCP) server that **complete rewrite** of the original superclaude mcp server with intelligent command routing, dynamic persona switching, and real mcp server orchestration for gemini cli.th It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Gemini Superclaude?
Follow the installation instructions on the Gemini Superclaude GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Gemini Superclaude?
Gemini Superclaude works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Gemini Superclaude free to use?
Yes, Gemini Superclaude is open source and available under the NOASSERTION license. You can use it freely in both personal and commercial projects.
Gemini Superclaude Alternatives — Similar Coding Agents Servers
Looking for alternatives to Gemini Superclaude? Here are other popular coding agents servers you can use with Claude, Cursor, and VS Code.
Dify
★ 142.2kProduction-ready platform for agentic workflow development.
Ruflo
★ 54.0k🌊 The leading agent orchestration platform for Claude. Deploy intelligent multi-agent swarms, coordinate autonomous workflows, and build conversational AI systems. Features enterprise-grade architecture, self-learning swarm intelligence, RAG integrat
Goose
★ 45.7kan open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM
Antigravity Awesome Skills
★ 38.3kInstallable GitHub library of 1,400+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.
AgentScope
★ 25.5kBuild and run agents you can see, understand and trust.
Serena
★ 24.5kA coding agent toolkit that provides IDE-like semantic code retrieval and editing tools, enabling LLMs to efficiently navigate and modify codebases using symbol-level operations instead of basic file reading and string replacements.
Browse More Coding Agents MCP Servers
Explore all coding agents servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Gemini Superclaude in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Gemini Superclaude?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.