Light Mode

Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly
Sign up
Appearance settings

RaiAnsar/Ultimate-MCP

Folders and files

NameName
Last commit message
Last commit date

Latest commit

History

16 Commits

Repository files navigation

Ultimate MCP Server

The Ultimate AI Coding Assistant

81 Powerful Tools | 50+ AI Models | Universal Platform Support

The definitive all-in-one Model Context Protocol (MCP) server that supercharges your AI coding experience across every major platform.

Quick Installation

Claude Desktop



npx @claude/create-mcp-server

Claude Code



claude mcp add ultimate

Cursor



Config Guide

VS Code



Continue Extension

Features

AI Models (50+)

  • OpenAI: GPT-4o, GPT-4o-mini, o1-preview
  • Anthropic: Claude 3 Opus, Sonnet, Haiku
  • Google: Gemini 2.5 Pro/Flash
  • xAI: Grok-2, Grok-3, Grok-4 (Beta)
  • DeepSeek: V3, R1, Coder V2
  • Meta: Llama 3.3 70B/405B
  • Mistral: Large 2411, Codestral
  • And many more...

Tool Categories (81 Tools)

  • Code Analysis: Error debugging, optimization
  • Code Generation: Multi-language support
  • Large Codebase: 1M+ token analysis
  • RAG System: Vector search, embeddings
  • Browser Automation: Web scraping, testing
  • UI/UX Analysis: Design system extraction
  • Cognitive Memory: Knowledge graphs
  • Content Management: Documentation

Installation Guides

Claude Desktop

Click to expand Claude Desktop setup

Method 1: Using Claude's Official Tool

npx @claude/create-mcp-server
# Select "ultimate-mcp-server" from the list

Method 2: Manual Configuration

  1. Open Claude Desktop settings
  2. Navigate to Developer - Model Context Protocol
  3. Click "Add Server" and enter:
    • Name: ultimate
    • Command: npx
    • Arguments: ultimate-mcp-server

Method 3: Edit Configuration File

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
"mcpServers": {
"ultimate": {
"command": "npx",
"args": ["ultimate-mcp-server"],
"env": {
"OPENROUTER_API_KEY": "your-key-here"
}
}
}
}

Claude Code

Click to expand Claude Code setup

Quick Install (Recommended)

claude mcp add ultimate npx ultimate-mcp-server

With API Keys

claude mcp add ultimate npx ultimate-mcp-server \
-e OPENROUTER_API_KEY=your-key \
-e ANTHROPIC_API_KEY=your-key \
-e GOOGLE_API_KEY=your-key

Local Development

# Clone and build
git clone https://github.com/RaiAnsar/ultimate-mcp-server.git
cd ultimate-mcp-server
npm install && npm run build

# Add local version
claude mcp add ultimate node ./dist/index.js

Verify Installation

claude mcp list
# Should show: ultimate: npx ultimate-mcp-server - Connected

Cursor

Click to expand Cursor setup
  1. Open Cursor Settings (Cmd/Ctrl + ,)
  2. Search for "MCP" or navigate to Features - MCP
  3. Click "Add MCP Server"
  4. Configure:
{
"name": "ultimate",
"command": "npx",
"args": ["ultimate-mcp-server"],
"env": {
"OPENROUTER_API_KEY": "your-key-here"
}
}
  1. Restart Cursor to activate

Alternative: Direct Config Edit

Edit ~/.cursor/config/settings.json:

{
"mcp": {
"servers": {
"ultimate": {
"command": "npx",
"args": ["ultimate-mcp-server"],
"env": {
"OPENROUTER_API_KEY": "your-key"
}
}
}
}
}

VS Code (Continue Extension)

Click to expand VS Code setup
  1. Install Continue extension from VS Code marketplace
  2. Open Continue settings (Cmd/Ctrl + Shift + P - "Continue: Open Settings")
  3. Add MCP configuration:
{
"models": [...],
"mcpServers": {
"ultimate": {
"command": "npx",
"args": ["ultimate-mcp-server"],
"env": {
"OPENROUTER_API_KEY": "your-key"
}
}
}
}
  1. Reload VS Code window

Windsurf

Click to expand Windsurf setup
  1. Open Windsurf Settings
  2. Navigate to AI - MCP Servers
  3. Click "Add Server"
  4. Enter configuration:
name: ultimate
command: npx
args:
- ultimate-mcp-server
env:
OPENROUTER_API_KEY: your-key
  1. Save and restart Windsurf

Cline

Click to expand Cline setup

Add to ~/.cline/config.json:

{
"mcpServers": {
"ultimate": {
"command": "npx",
"args": ["ultimate-mcp-server"],
"env": {
"OPENROUTER_API_KEY": "your-key"
}
}
}
}

Google AI Studio

Click to expand Google AI Studio setup
  1. Open Google AI Studio
  2. Go to Settings - Extensions
  3. Enable MCP Support
  4. Add server configuration:
{
"ultimate": {
"command": "npx",
"args": ["ultimate-mcp-server"],
"transport": "stdio"
}
}

API Configuration

Click to see all supported API providers

Required API Keys (at least one)

Provider Environment Variable Get API Key Models
OpenRouter OPENROUTER_API_KEY Get Key All 50+ models
Anthropic ANTHROPIC_API_KEY Get Key Claude models
OpenAI OPENAI_API_KEY Get Key GPT models
Google GOOGLE_API_KEY Get Key Gemini models
Perplexity PERPLEXITY_API_KEY Get Key Online search

Setting API Keys

Method 1: Environment Variables

export OPENROUTER_API_KEY="sk-or-..."
export ANTHROPIC_API_KEY="sk-ant-..."

Method 2: .env File

Create .env in your project:

OPENROUTER_API_KEY=sk-or-...
ANTHROPIC_API_KEY=sk-ant-...
GOOGLE_API_KEY=...

Method 3: MCP Configuration

Add to your MCP client config:

{
"env": {
"OPENROUTER_API_KEY": "your-key",
"ANTHROPIC_API_KEY": "your-key"
}
}

Usage Examples

Basic Commands

# Start server (stdio mode)
npx ultimate-mcp-server

# With specific transport
ENABLE_SSE=true npx ultimate-mcp-server

# With multiple transports
ENABLE_HTTP=true ENABLE_WEBSOCKET=true npx ultimate-mcp-server

Tool Examples

View code examples

Ask AI

// In your MCP client
await callTool('ask', {
prompt: 'Explain async/await in JavaScript',
model: 'openai/gpt-4o'
});

Analyze Error

await callTool('analyze_error', {
error: 'TypeError: Cannot read property "x" of undefined',
language: 'javascript'
});

Generate Code

await callTool('generate_code', {
description: 'Binary search algorithm',
language: 'python',
includeTests: true
});

Analyze Large Codebase

await callTool('analyze_large_codebase', {
rootDir: './src',
query: 'Find all API endpoints',
pattern: '.*\\.(ts|js)$'
});

Tool Categories

AI & Orchestration (10 tools)
  • ask - Query specific AI models
  • orchestrate - Multi-model orchestration
  • generate_code - AI code generation
  • explain_code - Code explanation
  • suggest_optimizations - Performance optimization
  • debugging_session - Interactive debugging
  • analyze_error - Error analysis
  • analyze_codebase - Codebase analysis
  • find_in_codebase - Pattern search
  • get_metrics - Performance metrics
Large Context Analysis (7 tools)
  • analyze_large_codebase - Analyze with 1M+ tokens
  • generate_directory_tree - Visual directory structure
  • collect_code_context - Context collection
  • analyze_project_structure - Architecture analysis
  • find_codebase_patterns - Pattern detection
  • generate_project_docs - Auto documentation
  • estimate_analysis_cost - Cost estimation
RAG & Memory (8 tools)
  • rag_ingest_document - Document ingestion
  • rag_search - Semantic search
  • rag_query - Q&A with sources
  • build_knowledge_graph - Graph construction
  • cognitive_search - Memory search
  • build_memory_context - Context building
  • get_related_memories - Related concepts
  • export_knowledge_graph - Graph export
Browser & UI (10 tools)
  • analyze_ui_design - UI/UX analysis
  • extract_design_system - Design tokens
  • check_ui_accessibility - WCAG compliance
  • compare_ui_designs - A/B comparison
  • suggest_ui_improvements - UX suggestions
  • analyze_ui_components - Component audit
  • create_ui_style_guide - Style documentation
  • analyze_user_flow - Journey mapping
  • browser_navigate - Web navigation
  • browser_screenshot - Page capture
Search & Navigation (5 tools)
  • universal_search - Multi-provider search
  • search_files - File search
  • search_content - Content grep
  • search_processes - Process search
  • search_everything - Unified search

Architecture

graph TB
A[MCP Client] -->|stdio/sse/http/ws| B[Transport Layer]
B --> C[Ultimate MCP Server]
C --> D[Tool Registry - 81 Tools]
C --> E[AI Orchestrator]
C --> F[Resource Manager]

E --> G[OpenRouter - 50+ Models]
E --> H[Direct Providers]

D --> I[Code Intelligence]
D --> J[Browser Automation]
D --> K[RAG System]
D --> L[UI Analysis]
Loading

Development

# Clone repository
git clone https://github.com/RaiAnsar/ultimate-mcp-server.git
cd ultimate-mcp-server

# Install dependencies
npm install

# Build project
npm run build

# Run tests
npm test

# Development mode
npm run dev

Project Structure

ultimate-mcp-server/
+-- src/
| +-- core/ # Core MCP functionality
| +-- tools/ # All 81 tools
| +-- providers/ # AI providers
| +-- transports/ # Transport layers
| +-- utils/ # Utilities
+-- dist/ # Compiled output
+-- package.json

Contributing

Contributions are welcome! Please read our Contributing Guide for details.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

[SOS] Support

Star History

Built with by Rai Ansar and contributors

Star us on GitHub * Share on Twitter

About

An MCP to be used with OpenRouter API key to use the best models for debugging and content creation.

Resources

Readme

License

MIT license

Stars

Watchers

Forks

Releases

No releases published

Packages

Contributors