Package Exports
- ultimate-mcp-server
- ultimate-mcp-server/dist/index.js
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (ultimate-mcp-server) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
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 listMethod 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-serverWith 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-keyLocal 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.jsVerify Installation
claude mcp list
# Should show: ultimate: npx ultimate-mcp-server - ✓ ConnectedCursor
⚡ 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-serverTool 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 devProject 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