# Atlas Mcp Server

> 7-stage AI pipeline MCP server: Intent→Context→Git→Decompose→Variants→Critique→Optimize

- **Type:** MCP server
- **Install:** `agentstack add mcp-iamnishant51-atlas-mcp-server`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [IamNishant51](https://agentstack.voostack.com/s/iamnishant51)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 1.0.1
- **License:** MIT
- **Upstream author:** [IamNishant51](https://github.com/IamNishant51)
- **Source:** https://github.com/IamNishant51/atlas-mcp-server

## Install

```sh
agentstack add mcp-iamnishant51-atlas-mcp-server
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Atlas MCP Server

[](https://www.npmjs.com/package/atlas-pipeline-mcp)
[](https://www.npmjs.com/package/atlas-pipeline-mcp)
[](https://opensource.org/licenses/MIT)
[](https://www.typescriptlang.org/)
[](https://nodejs.org/)

**Enterprise-Grade Agentic AI Pipeline for Modern IDEs**

Advanced AI/ML-powered development tools with RAG search, ML bug prediction, intelligent code migration, and comprehensive test generation.

[Installation](#installation) • [Features](#key-features) • [Tools](#available-tools) • [Usage](#usage-guide) • [Documentation](#advanced-integration)

---

## Overview

Atlas MCP Server transforms your IDE with intelligent development capabilities through a comprehensive analysis pipeline:

**Intent → Context → Decomposition → Variants → Critique → Optimization**

Natively integrated with **Cursor**, **Windsurf**, **Claude Desktop**, **GitHub Copilot**, and **VS Code**.

---

## What's New in Latest Version

### Advanced Development Tools Suite

The latest version introduces six powerful tools designed to address complex development challenges:

**New Advanced Analysis Tools:**

Bug Oracle
Predictive bug detection system analyzing code patterns, complexity metrics, and historical data to forecast potential issues before they occur

Code Whisperer
Intelligent code suggestion engine providing context-aware recommendations, pattern detection, and best practice enforcement

Codebase Surgeon
Precision refactoring tool for large-scale codebase transformations with dependency-aware modifications and impact analysis

**Enhanced Development Experience:**

Semantic Search
Advanced code search with natural language understanding, finding code by intent rather than keywords

Smart Merge Resolver
Intelligent conflict resolution for git merges using code analysis and context understanding to suggest optimal merge strategies

Tech Debt Quantifier
Technical debt measurement and tracking system with actionable metrics and prioritized remediation roadmaps

### Frontend Developer Tools

Comprehensive suite for modern frontend development:

Performance Doctor
Detects React/Vue re-render issues, bundle bloat, memory leaks, and provides specific code fixes with improvement estimates

CSS Wizard
CSS architecture analyzer - detects specificity conflicts, generates design tokens, converts between BEM/Tailwind/CSS Modules/styled-components

Animation Studio
Professional animation generator - CSS keyframes, Framer Motion, GSAP timelines, micro-interactions with accessibility support

API Helper
API integration assistant - generates TypeScript types, React Query/SWR hooks, mock data, Zod schemas, and error handling

---

## Senior Developer Tools

Expert-level guidance and analysis:

Senior Mentor
Architectural guidance from a 15+ year veteran perspective with trade-off analysis and senior lessons

Performance Optimizer
Deep performance analysis with Web Vitals optimization and bottleneck detection

Security Scanner
Enterprise-grade vulnerability detection with compliance assessment (GDPR, CCPA, HIPAA, PCI-DSS)

State Management Architect
Pattern comparison and scalability analysis for Redux, Zustand, Jotai, Recoil, and more

API Design Consultant
RESTful and GraphQL API design review with best practices and documentation templates

## AI/ML Powered Tools

Advanced machine learning capabilities:

RAG Search
Semantic code search with knowledge graphs and natural language queries

ML Predictor
Bug & performance prediction with 70-85% accuracy using machine learning

Code Migration
Intelligent migration (12 types: JS→TS, React upgrades, Callbacks→Async)

Test Generator
Advanced test generation with edge cases, mocks, and property-based testing

## Core Professional Tools

Essential development utilities:

Refactor
Code refactoring engine with complexity analysis

Profiler
Performance profiling & bottleneck detection (O(n), O(n²), etc.)

Review
Automated code review with quality scores and security checks

Dependencies
Dependency analysis, unused package detection, vulnerability scanning

Dashboard
Interactive HTML metrics dashboards with real-time data

Security
Security vulnerability scanning (CWE, OWASP standards)

Test Gen
Comprehensive test case generation (Jest, Vitest, Pytest, Mocha)

Docs Gen
Auto-generate documentation (JSDoc, TSDoc, PyDoc)

---

## Key Features

### AI/ML Capabilities
- **RAG Search** - Semantic code understanding with knowledge graphs
- **ML Prediction** - Bug & performance forecasting (70-85% accuracy)
- **Code Migration** - 12 intelligent migration types
- **Test Generation** - Advanced test suites with edge cases
- **Bug Oracle** - Predictive bug detection and prevention
- **Semantic Search** - Natural language code discovery

### Professional Tools
- **Full Pipeline** - Intent → Context → Variants → Optimize
- **Quality Analysis** - Code review, security, complexity
- **Performance** - Profiling, bottleneck detection
- **Automation** - Tests, docs, refactoring
- **Tech Debt** - Quantification and tracking
- **Merge Resolution** - Intelligent conflict handling

### Why Choose Atlas?

- **Zero Configuration**: No API keys required - leverages your IDE's built-in AI (Copilot/Cursor)
- **33 Professional Tools**: Comprehensive suite covering all development needs
- **Agentic Workflow**: DAG-based task decomposition for complex problems
- **Context Aware**: Deep project structure, dependencies, and git history analysis
- **High Performance**: LRU caching, request deduplication, parallel execution
- **Enterprise Ready**: Production-grade tools with security and compliance features

---

## Installation

### Quick Start (Recommended)

**Step 1: Install Globally**

Open your terminal and run:

```bash
npm install -g atlas-pipeline-mcp
```

**Step 2: Run Auto-Setup**

Automatically configure your IDE (Cursor or VS Code):

```bash
atlas-mcp-setup
```

**Step 3: Restart IDE**

Restart your editor. The Atlas server will be automatically connected and ready to use.

---

## Available Tools

### Advanced Development & Analysis Tools

atlas_bug_oracle
Bug OraclePredictive bug detection analyzing code patterns, complexity metrics, and historical data to forecast potential issues with 70-85% accuracy.

atlas_code_whisperer
Code WhispererContext-aware code suggestions with pattern detection, best practice enforcement, and intelligent auto-completion.

atlas_codebase_surgeon
Codebase SurgeonLarge-scale refactoring with dependency-aware modifications, impact analysis, and safe transformation strategies.

atlas_semantic_search
Semantic SearchNatural language code search finding code by intent rather than keywords, with context understanding.

atlas_smart_merge
Smart Merge ResolverIntelligent git conflict resolution using code analysis and context to suggest optimal merge strategies.

atlas_tech_debt
Tech Debt QuantifierMeasures and tracks technical debt with actionable metrics and prioritized remediation roadmaps.

### AI/ML Powered Tools

atlas_rag_search
RAG-Powered Semantic SearchNatural language code search with knowledge graphs. Ask "how does auth work?" and get contextual results.

atlas_ml_predict
ML Bug & Performance PredictionPredict bugs before production with 70-85% accuracy. Analyzes complexity, churn, and code patterns.

atlas_migrate
Intelligent Code MigrationAutomated migration support for 12 types: JS→TS, React upgrades, Callbacks→Async, and more.

atlas_testgen_advanced
Advanced Test GenerationGenerate comprehensive test suites with edge cases, mocks, stubs, and 90%+ coverage projection.

### Core Pipeline & Analysis Tools

atlas_pipeline
Full Agentic PipelineComplete workflow: Intent → Context → Decompose → Variants → Critique → Optimize

atlas_intent
Intent AnalysisExtract actionable intent from natural language requests

atlas_context
Project Context GatheringAnalyze project structure, dependencies, and file relationships

atlas_git
Git History AnalysisAnalyze commits, branches, file changes, and code evolution

atlas_decompose
Task DecompositionBreak complex tasks into DAG (Directed Acyclic Graph) of subtasks

atlas_variants
Solution VariantsGenerate multiple implementation approaches with pros/cons analysis

### Quality & Optimization Tools

atlas_review
Automated Code ReviewComprehensive analysis with quality scores, security checks, and best practice validation

atlas_critique
Code CritiqueDeep review for quality, security, performance, and maintainability

atlas_optimize
Code OptimizationApply improvements based on critique feedback and best practices

atlas_refactor
Smart RefactoringCode restructuring with complexity metrics and structural analysis

atlas_security
Security ScannerDetect vulnerabilities with CWE IDs and OWASP category mapping

### Senior Developer Tools

atlas_senior_mentor
Senior MentorArchitectural guidance from 15+ year veteran perspective with trade-off analysis and senior lessons

atlas_performance_optimizer
Performance OptimizerDeep performance analysis with Web Vitals optimization and bottleneck detection

atlas_security_scanner
Security Scanner ProEnterprise-grade vulnerability detection with compliance assessment (GDPR, CCPA, HIPAA, PCI-DSS)

atlas_state_architect
State Management ArchitectPattern comparison and scalability analysis for Redux, Zustand, Jotai, Recoil

atlas_api_consultant
API Design ConsultantRESTful and GraphQL API design review with best practices and documentation templates

### UI/UX Design Tools

atlas_ui_ux_designer
UI/UX DesignerFind best design inspirations online, generate multiple design options with images, and create production-ready code. Supports React, Vue, HTML, Svelte with accessibility guidance.

### Frontend Developer Tools

atlas_performance_doctor
Frontend Performance DoctorDetects React/Vue re-render issues, bundle bloat, memory leaks, Core Web Vitals issues. Provides specific code fixes with improvement estimates (e.g., "30-50% fewer re-renders").

atlas_css_wizard
CSS Architecture WizardAnalyzes CSS specificity conflicts, generates design tokens, converts between BEM/Tailwind/CSS Modules/styled-components/Emotion. Finds unused CSS and duplicates.

atlas_animation_studio
Animation StudioProfessional animation generator with 30+ presets. Creates CSS keyframes, Framer Motion, GSAP, React Spring, and Anime.js code. Includes micro-interactions, scroll animations, and accessibility support.

atlas_api_helper
API Integration HelperGenerates TypeScript types from API responses, React Query/SWR hooks, MSW mock handlers, Zod validation schemas, and complete API clients with error handling.

### Development Productivity Tools

atlas_profiler
Performance ProfilingDetect bottlenecks, analyze time complexity (O(n), O(n²)), and memory usage

atlas_test
Test Case GenerationGenerate comprehensive tests for Jest, Vitest, Pytest, Mocha

atlas_docs
Auto DocumentationGenerate JSDoc, TSDoc, or PyDoc documentation automatically

atlas_dependencies
Dependency AnalysisDetect unused packages, analyze dependencies, scan for vulnerabilities

atlas_dashboard
Metrics DashboardGenerate interactive HTML dashboards with real-time metrics

atlas_explain
Code ExplanationExplain code with complexity analysis and pattern detection

atlas_debug
Smart DebuggingRoot cause analysis, stack trace parsing, and fix suggestions

atlas_think
Advanced ReasoningSequential reasoning with branching logic for complex problems

### Utility Tools

atlas_providers
Provider StatusCheck available LLM providers and their current status

---

## Usage Guide

Once installed, interact with your AI Assistant (Copilot Chat or Cursor Chat). The appropriate tool is automatically activated based on your request.

### Advanced Development Tools

| Goal | Example Request | Tool Used |
| :--- | :--- | :--- |
| **Predict Bugs** | "Analyze bug probability in this module" | `atlas_bug_oracle` |
| **Get Code Suggestions** | "Suggest improvements for this function" | `atlas_code_whisperer` |
| **Large-Scale Refactoring** | "Refactor the entire authentication system" | `atlas_codebase_surgeon` |
| **Search by Intent** | "Find where we handle payment processing" | `atlas_semantic_search` |
| **Resolve Conflicts** | "Help resolve this merge conflict intelligently" | `atlas_smart_merge` |
| **Measure Tech Debt** | "Quantify technical debt in this project" | `atlas_tech_debt` |

### AI/ML Tools

| Goal | Example Request | Tool Used |
| :--- | :--- | :--- |
| **Semantic Code Search** | "Search for authentication code using RAG" | `atlas_rag_search` |
| **Predict Issues** | "Predict bug probability in payment-processor.ts" | `atlas_ml_predict` |
| **Migrate Codebase** | "Migrate this file from JavaScript to TypeScript" | `atlas_migrate` |
| **Advanced Testing** | "Generate comprehensive tests with edge cases" | `atlas_testgen_advanced` |

### Professional Development Tools

| Goal | Example Request | Tool Used |
| :--- | :--- | :--- |
| **Full Pipeline** | "Run the pipeline on utils.ts to refactor it" | `atlas_pipeline` |
| **Refactor Code** | "Refactor this code and reduce complexity" | `atlas_refactor` |
| **Performance Analysis** | "Profile this code for performance bottlenecks" | `atlas_profiler` |
| **Code Review** | "Review this PR for quality and security" | `atlas_review` |
| **Check Dependencies** | "Analyze dependencies and find unused packages" | `atlas_dependencies` |
| **Plan Feature** | "Decompose the task of adding JWT auth" | `atlas_decompose` |
| **Explore Solutions** | "Generate 3 variants for this button component" | `atlas_variants` |
| **Review Code** | "Critique this code for security issues" | `atlas_critique` |
| **Polish Code** | "Optimize this function based on best practices" | `atlas_optimize` |
| **Security Scan** | "Scan this code for security vulnerabilities" | `atlas_security` |
| **Generate Tests** | "Generate tests for this authentication module" | `atlas_test` |
| **Add Documentation** | "Document this API with examples" | `atlas_docs` |
| **Understand Code** | "Explain how this algorithm works" | `atlas_explain` |
| **Debug Error** | "Debug this TypeError, here's the stack trace..." | `atlas_debug` |
| **Complex Reasoning** | "Think through how to design this system" | `atlas_think` |
| **Project Context** | "Analyze the project context and dependencies" | `atlas_context` |

---

## Advanced Integration

### Using Local LLMs

If you prefer running models locally (e.g., Ollama) or want to use your own API keys instead of your IDE's subscription, configure the server manually in your settings:

```json
{
  "atlas": {
    "command": "npx",
    "args": ["-y", "atlas-pipeline-mcp"],
    "env": {
      "OLLAMA_BASE_URL": "http://localhost:11434",
      "OPENAI_API_KEY": "sk-...",
      "ANTHROPIC_API_KEY": "sk-..."
    }
  }
}
```

**Note:** If no API keys are provided, Atlas defaults to **Client Sampling mode**, delegating generation to your IDE's AI capabilities.

---

## Contributing

We welcome contributions to improve the Atlas pipeline.

- **Repository**: [github.com/IamNishant51/atlas-mcp-server](https://github.com/IamNishant51/atlas-mcp-server)
- **Issues**: Report bugs or request features on GitHub
- **Pull Requests**: Submit improvements and new features

---

## License

MIT License - see LICENSE file for details

---

**Built by Nishant Unavane**

---
🌐 **Check out my portfolio:** [nishantunavane.qzz.io](https://nishantunavane.qzz.io)

For support, documentation, or questions, visit our [GitHub repository](https://github.com/IamNishant51/atlas-mcp-server).

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [IamNishant51](https://github.com/IamNishant51)
- **Source:** [IamNishant51/atlas-mcp-server](https://github.com/IamNishant51/atlas-mcp-server)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v1.0.1 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **1.0.1** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-iamnishant51-atlas-mcp-server
- Seller: https://agentstack.voostack.com/s/iamnishant51
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.