CodeAtlas AI MCP Server

┌──────────────────────────────────────────────────┐
│                   MCP Clients                     │
│  Claude  Cursor  VS Code  Windsurf  Custom CLI   │
└────────────────────┬─────────────────────────────┘
                     │
┌────────────────────▼─────────────────────────────┐
│              Presentation Layer                    │
│  ┌──────────────────┐  ┌──────────────────────┐  │
│  │   MCP Server     │  │  Express HTTP API    │  │
│  │  (stdio / SSE)   │  │  (REST Endpoints)    │  │
│  │  mcpServer.ts    │  │  httpServer.ts       │  │
│  │  mcpTools.ts     │  │  dreamingRoutes.ts   │  │
│  └──────────────────┘  └──────────────────────┘  │
└────────────────────┬─────────────────────────────┘
                     │
┌────────────────────▼─────────────────────────────┐
│               Service Layer                       │
│  ┌────────────┐ ┌──────────┐ ┌────────────────┐  │
│  │  Project   │ │ Memory   │ │  Security      │  │
│  │  Service   │ │ Service  │ │  Scanner       │  │
│  │            │ │          │ │                │  │
│  │ project    │ │ Oracle   │ │ Security       │  │
│  │ Service.ts │ │ Memory   │ │ Scanner.ts     │  │
│  │            │ │ Service  │ │                │  │
│  └────────────┘ │ .ts      │ │                │  │
│                  │          │ └────────────────┘  │
│  ┌────────────┐ │ ┌──────┐ │                     │
│  │ Dreaming   │ │ │Embed │ │                     │
│  │ Service    │ │ │-ding │ │                     │
│  │            │ │ │Service││                     │
│  │ dreaming  │ │ │.ts   ││                     │
│  │ Service.ts │ │ └──────┘ │                     │
│  └────────────┘ └──────────┘                     │
└────────────────────┬─────────────────────────────┘
                     │
┌────────────────────▼─────────────────────────────┐
│              Infrastructure Layer                  │
│  ┌──────────┐ ┌──────────┐ ┌──────────────────┐  │
│  │ Oracle   │ │ Firebase │ │ File System      │  │
│  │ 26ai DB  │ │ Admin    │ │ (codeatlas/       │  │
│  │          │ │          │ │  analysis.json)   │  │
│  │ .connect │ │ .auth    │ │                  │  │
│  │ .memory  │ │ .firestore│ │ projectService   │  │
│  │ .schema  │ │          │ │ .ts              │  │
│  └──────────┘ └──────────┘ └──────────────────┘  │
└──────────────────────────────────────────────────┘

1. User opens IDE (Claude / Cursor / VS Code)
2. IDE connects to CodeAtlas via MCP (stdio or SSE)
3. MCP tools query local .codeatlas/analysis.json AST data
4. sync_system_memory pushes embeddings & relationships to Oracle 26ai
5. Dashboard fetches analysis results via REST API
6. Security Scanner runs against analysis data for vulnerability detection
7. Knowledge Graph queries (Oracle Property Graph) identify architectural smells

# Clone the repository
git clone https://github.com/giauphan/codeatlas-platform.git
cd codeatlas-platform

# Install dependencies
pnpm install

# Build the TypeScript project
pnpm run build

# Server Configuration
PORT=8080
NODE_ENV=production
LOG_LEVEL=info

# Authentication
CODEATLAS_API_KEY=your_admin_secret_key
GOOGLE_APPLICATION_CREDENTIALS=/path/to/firebase-service-account.json

# Oracle 26ai Database (Thick Mode)
ORACLE_USER=admin
ORACLE_PASSWORD=your_password
ORACLE_CONN_STRING=your_db_connection_string
ORACLE_LIB_DIR=/opt/oracle/instantclient
ORACLE_WALLET_DIR=/opt/oracle/wallet   # For mTLS connections

# NVIDIA Embeddings
NVIDIA_API_KEY=nvapi-your-key-here

# Multi-Tenant (optional)
CODEATLAS_MULTI_TENANT=false
CODEATLAS_PROJECTS_ROOT=./tenants

# CORS (optional, defaults to localhost origins)
ALLOWED_ORIGINS=http://localhost:5173,http://localhost:3000

pnpm run dev

pnpm run build
pnpm run start

npm install -g pm2
pm2 start dist/src/index.js --name codeatlas-platform
pm2 save
pm2 startup

pnpm run db-init

{
  "mcpServers": {
    "codeatlas": {
      "command": "npx",
      "args": ["-y", "codeatlas-enterprise"],
      "env": {
        "CODEATLAS_API_KEY": "your-api-key",
        "ORACLE_CONN_STRING": "...",
        "NVIDIA_API_KEY": "nvapi-..."
      }
    }
  }
}

{
  "mcpServers": {
    "codeatlas": {
      "type": "sse",
      "url": "https://your-server.com/sse?apiKey=YOUR_API_KEY_HERE"
    }
  }
}

---
description: CodeAtlas AI codebase intelligence
globs: *
---
An MCP server named `codeatlas` is available with code analysis tools.
Always use it before manual file searches for faster results.

{
  "mcpServers": {
    "codeatlas": {
      "command": "npx",
      "args": ["-y", "codeatlas-enterprise"],
      "env": {
        "CODEATLAS_API_KEY": "your-api-key"
      }
    }
  }
}

{
  "mcpServers": {
    "codeatlas": {
      "command": "npx",
      "args": ["-y", "codeatlas-enterprise"],
      "env": {
        "CODEATLAS_API_KEY": "your-api-key"
      }
    }
  }
}

Use CodeAtlas MCP tools for codebase analysis before making changes.
Tools: list_projects, get_project_structure, search_entities, get_dependencies,
generate_system_flow, trace_feature_flow, sync_system_memory

npx -y codeatlas-enterprise

curl -N https://your-server.com/sse?apiKey=YOUR_API_KEY

codeatlas-platform/
├── src/
│   ├── index.ts                       # Composition root — entry point
│   ├── config/
│   │   └── env.ts                     # Environment configuration
│   ├── presentation/                   # Presentation layer (MCP + HTTP)
│   │   ├── mcpServer.ts               # MCP server instance
│   │   ├── mcpTools.ts                # All 14 MCP tool definitions
│   │   ├── httpServer.ts              # Express HTTP server + REST API
│   │   └── dreamingRoutes.ts          # Dream memory REST routes
│   ├── services/                       # Application services
│   │   ├── authService.ts             # Authentication & API key verification
│   │   ├── projectService.ts          # Project discovery & analysis loading
│   │   ├── memoryService.ts           # Oracle 26ai tri-layer memory service
│   │   ├── dreamingService.ts         # Oracle dreaming memory service
│   │   ├── embeddingService.ts        # NVIDIA NIM embedding generation
│   │   ├── memoryGenerator.ts         # Auto-generated memory documentation
│   │   └── scanner/
│   │       └── securityScanner.ts     # Static security vulnerability scanner
│   ├── middleware/
│   │   └── auth.ts                    # Express auth middleware (Firebase + API key)
│   ├── database/
│   │   ├── connection.ts              # Oracle DB connection pool (Thick Mode)
│   │   └── schema.sql                 # Oracle 26ai database schema + VPD setup
│   ├── types/
│   │   ├── index.ts                   # TypeScript interfaces (GraphNode, AnalysisResult, etc.)
│   │   └── express.d.ts              # Express type augmentation
│   ├── utils/
│   │   ├── logger.ts                  # Structured logging
│   │   └── context.ts                 # AsyncLocalStorage for request context
│   └── repositories.ts                # Repository pattern (auth, telemetry)
├── dashboard/                          # React dashboard (Vite + TypeScript)
│   ├── src/
│   │   ├── App.tsx                    # Root component
│   │   ├── main.tsx                   # Entry point
│   │   ├── lib/
│   │   │   └── firebase.ts           # Firebase client SDK
│   │   └── components/
│   │       ├── Dashboard.tsx          # Main dashboard (project management)
│   │       ├── Auth.tsx               # Login / API key auth
│   │       ├── KnowledgeGraphView.tsx # Interactive force-directed graph
│   │       ├── ControlCenterView.tsx  # Settings & controls
│   │       ├── CloudIndexView.tsx     # Cloud sync status
│   │       └── DocumentationView.tsx  # MCP integration guide
│   ├── index.html
│   ├── vite.config.ts
│   └── package.json
├── scripts/                            # Utility scripts
│   ├── db-init.ts                     # Database schema initialization
│   ├── deploy.sh                      # Deployment script
│   ├── migrate-user.ts                # User migration
│   └── query-firestore.ts             # Firestore debugging
├── tests/                              # Test suites
│   ├── unit/                          # Unit tests
│   ├── integration/                   # Integration tests
│   └── e2e/                           # End-to-end tests
├── docs/
│   ├── QUICK_SETUP.md                 # Quick setup guide
│   ├── AI-MEMORY-SETUP.md            # AI memory configuration
│   └── rules-template/               # IDE integration templates
│       ├── CLAUDE.md
│       ├── cursor-codeatlas.mdc
│       ├── codeatlas-mcp.md
│       └── windsurfrules.md
├── instantclient/                      # Oracle Instant Client libraries
├── .github/workflows/
│   ├── ci.yml                         # CI pipeline (build, type-check, test)
│   └── cd.yml                         # CD pipeline (deploy to live server)
├── package.json
├── tsconfig.json
├── DESIGN.md                           # Design system specification
├── CHANGELOG.md                        # Full version history
└── LICENSE                             # MIT License

tenants/
├── tenant-abc123/
│   ├── project-alpha/
│   │   └── .codeatlas/analysis.json
│   └── project-beta/
└── tenant-def456/
    └── project-gamma/

cd dashboard
pnpm install
pnpm run build     # Production build
pnpm run dev       # Development server

# Run all tests
pnpm test

# Run TypeScript type checking
npx tsc --noEmit --skipLibCheck

# Run dashboard tests
cd dashboard && pnpm test

tests/
├── unit/
│   ├── scanner.test.ts                  # Security scanner logic
│   ├── repositories.test.ts            # Auth & telemetry repository
│   ├── dreaming-service.test.ts        # Dreaming service operations
│   ├── dreaming-routes.test.ts         # Dream memory REST endpoints
│   └── memory-generator.test.ts        # Memory documentation generator
├── integration/
│   ├── api.test.ts                     # REST API endpoints
│   ├── mcp.test.ts                     # MCP tool execution
│   ├── database.test.ts               # Oracle DB operations
│   ├── multi-tenant.test.ts           # Tenant isolation
│   ├── project-deletion.test.ts       # Project cleanup flow
│   ├── discovery.test.ts              # Project discovery
│   ├── settings.test.ts               # Indexing settings API
│   └── watcher.test.ts                # File watcher
└── e2e/
    └── scan-flow.test.ts               # End-to-end analysis flow

MIT License

Copyright (c) 2026 GiauPhan

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
...