ultimate-server
An MCP to be used with OpenRouter API key to use the best models for debugging and content creation.
Installation
npx ultimate-mcp-serverAsk AI about ultimate-server
Powered by Claude Β· Grounded in docs
I know everything about ultimate-server. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
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 Desktopnpx @claude/create-mcp-server
|
Claude Codeclaude mcp add ultimate
|
Cursorπ Config Guide |
VS Codeπ Continue Extension |
β¨ Features
π€ AI Models (50+)
|
π οΈ Tool Categories (81 Tools)
|
π¦ 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
- Open Claude Desktop settings
- Navigate to Developer β Model Context Protocol
- Click "Add Server" and enter:
- Name:
ultimate - Command:
npx - Arguments:
ultimate-mcp-server
- Name:
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
- Open Cursor Settings (
Cmd/Ctrl + ,) - Search for "MCP" or navigate to Features β MCP
- Click "Add MCP Server"
- Configure:
{
"name": "ultimate",
"command": "npx",
"args": ["ultimate-mcp-server"],
"env": {
"OPENROUTER_API_KEY": "your-key-here"
}
}
- 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
- Install Continue extension from VS Code marketplace
- Open Continue settings (
Cmd/Ctrl + Shift + Pβ "Continue: Open Settings") - Add MCP configuration:
{
"models": [...],
"mcpServers": {
"ultimate": {
"command": "npx",
"args": ["ultimate-mcp-server"],
"env": {
"OPENROUTER_API_KEY": "your-key"
}
}
}
}
- Reload VS Code window
Windsurf
π Click to expand Windsurf setup
- Open Windsurf Settings
- Navigate to AI β MCP Servers
- Click "Add Server"
- Enter configuration:
name: ultimate
command: npx
args:
- ultimate-mcp-server
env:
OPENROUTER_API_KEY: your-key
- 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
- Open Google AI Studio
- Go to Settings β Extensions
- Enable MCP Support
- 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_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 modelsorchestrate- Multi-model orchestrationgenerate_code- AI code generationexplain_code- Code explanationsuggest_optimizations- Performance optimizationdebugging_session- Interactive debugginganalyze_error- Error analysisanalyze_codebase- Codebase analysisfind_in_codebase- Pattern searchget_metrics- Performance metrics
π Large Context Analysis (7 tools)
analyze_large_codebase- Analyze with 1M+ tokensgenerate_directory_tree- Visual directory structurecollect_code_context- Context collectionanalyze_project_structure- Architecture analysisfind_codebase_patterns- Pattern detectiongenerate_project_docs- Auto documentationestimate_analysis_cost- Cost estimation
π§ RAG & Memory (8 tools)
rag_ingest_document- Document ingestionrag_search- Semantic searchrag_query- Q&A with sourcesbuild_knowledge_graph- Graph constructioncognitive_search- Memory searchbuild_memory_context- Context buildingget_related_memories- Related conceptsexport_knowledge_graph- Graph export
π Browser & UI (10 tools)
analyze_ui_design- UI/UX analysisextract_design_system- Design tokenscheck_ui_accessibility- WCAG compliancecompare_ui_designs- A/B comparisonsuggest_ui_improvements- UX suggestionsanalyze_ui_components- Component auditcreate_ui_style_guide- Style documentationanalyze_user_flow- Journey mappingbrowser_navigate- Web navigationbrowser_screenshot- Page capture
π Search & Navigation (5 tools)
universal_search- Multi-provider searchsearch_files- File searchsearch_content- Content grepsearch_processes- Process searchsearch_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]
π§ 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.
- Fork the repository
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
π License
This project is licensed under the MIT License - see the LICENSE file for details.
π Support
- Documentation: Full Docs
- Issues: Report Bug
- Discussions: Community Forum
- Discord: Join Server
β Star History
Built with β€οΈ by Rai Ansar and contributors
