codeatlas-enterprise 1.0.0

package/README.md

@@ -0,0 +1,76 @@
+# CodeAtlas Enterprise MCP Gateway
+
+An ultra-lightweight, high-performance Model Context Protocol (MCP) gateway that securely bridges your local AI editors (Cursor, Claude Code, Roo Code, VS Code) to the remote **CodeAtlas Enterprise Server**. 
+
+This client-only gateway requires no heavy database engines, AST parsers, or workspace indexers locally. All complex AI analysis and persistence run secure and isolated in the cloud, giving you instant, lightning-fast response times with zero local CPU overhead.
+
+---
+
+## 🚀 Installation
+
+Install globally using `npm` (or `yarn`/`pnpm`):
+
+```bash
+npm install -g codeatlas-enterprise
+```
+
+---
+
+## 🔑 Authentication
+
+The gateway communicates securely with the CodeAtlas server using your personal **API Key**. You can provide the API Key in one of three ways:
+
+1. **Environment Variable**:
+   ```bash
+   export CODEATLAS_API_KEY="your_api_key_here"
+   ```
+2. **Local `.env` File**:
+   Create a `.env` file in the directory where you run the command:
+   ```env
+   CODEATLAS_API_KEY="your_api_key_here"
+   ```
+3. **CLI Argument**:
+   ```bash
+   codeatlas-mcp --apiKey="your_api_key_here"
+   ```
+
+---
+
+## 🛠 AI Editor Integration
+
+### 1. Cursor / Claude Desktop / VS Code
+Add the following to your global MCP settings file (e.g., `mcp_config.json` or `.cursor/mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "codeatlas": {
+      "command": "codeatlas-mcp",
+      "args": [
+        "--apiKey",
+        "YOUR_API_KEY_HERE"
+      ]
+    }
+  }
+}
+```
+
+### 2. Custom Command Line Execution
+You can also launch it manually in standard input/output mode:
+
+```bash
+codeatlas-mcp --apiKey="YOUR_API_KEY_HERE"
+```
+
+---
+
+## 🔒 Absolute Privacy & Security
+
+* **Zero Local Code Storage**: This client package contains only the necessary transport bridge code. Your intellectual property, credentials, and structural data are never saved on the local machine where this package is installed.
+* **Encrypted Transmission**: All data exchanged between your local editor and the server is fully encrypted via secure HTTPS/SSE channels.
+
+---
+
+## 📄 License
+
+UNLICENSED — All Rights Reserved. Used exclusively for licensed CodeAtlas Enterprise customers.

package/bin/codeatlas.js

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+
+import { spawn } from 'child_process';
+import * as fs from 'fs';
+import * as path from 'path';
+
+// Load API Key from environment or arguments or local .env
+let apiKey = process.env.CODEATLAS_API_KEY;
+
+// Check command line arguments for --apiKey=<value> or -k <value>
+const args = process.argv.slice(2);
+for (let i = 0; i < args.length; i++) {
+  if (args[i].startsWith('--apiKey=')) {
+    apiKey = args[i].split('=')[1];
+  } else if (args[i] === '-k' || args[i] === '--apiKey') {
+    apiKey = args[i + 1];
+  }
+}
+
+// Fallback to local .env file in the current working directory
+if (!apiKey) {
+  try {
+    const envPath = path.join(process.cwd(), '.env');
+    if (fs.existsSync(envPath)) {
+      const envContent = fs.readFileSync(envPath, 'utf8');
+      const match = envContent.match(/CODEATLAS_API_KEY=["']?([^"'\s]+)["']?/);
+      if (match) {
+        apiKey = match[1];
+      }
+    }
+  } catch (e) {
+    // Ignore .env read error
+  }
+}
+
+if (!apiKey) {
+  console.error('Error: CODEATLAS_API_KEY is not set.');
+  console.error('Please set it in your environment variables, a local .env file, or pass it as an argument:');
+  console.error('  codeatlas-mcp --apiKey=YOUR_API_KEY');
+  process.exit(1);
+}
+
+// Target remote SSE URL
+const sseUrl = `https://atlas.genrostore.com/sse?apiKey=${apiKey}`;
+
+console.error(`Connecting to CodeAtlas Remote Server via Supergateway...`);
+console.error(`SSE URL: https://atlas.genrostore.com/sse?apiKey=***`);
+
+// Spawn supergateway
+// We try to run the local/global 'supergateway' binary first.
+// If it fails or is not found, we run it via npx.
+const gatewayArgs = ['--sse', sseUrl];
+
+let child;
+try {
+  child = spawn('supergateway', gatewayArgs, { stdio: 'inherit' });
+} catch (err) {
+  // If global 'supergateway' is not found, spawn it via 'npx'
+  child = spawn('npx', ['-y', '@modelcontextprotocol/supergateway', ...gatewayArgs], { stdio: 'inherit' });
+}
+
+child.on('error', (err) => {
+  console.error('Failed to start supergateway process:', err);
+  process.exit(1);
+});
+
+child.on('exit', (code) => {
+  process.exit(code || 0);
+});

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "codeatlas-enterprise",
+  "version": "1.0.0",
+  "description": "Ultra-lightweight MCP Gateway for CodeAtlas Remote Enterprise Server",
+  "type": "module",
+  "bin": {
+    "codeatlas-mcp": "bin/codeatlas.js"
+  },
+  "scripts": {
+    "start": "node bin/codeatlas.js"
+  },
+  "keywords": [
+    "mcp",
+    "modelcontextprotocol",
+    "codeatlas",
+    "enterprise"
+  ],
+  "author": "giauphan",
+  "license": "UNLICENSED",
+  "dependencies": {
+    "@modelcontextprotocol/supergateway": "^0.2.0"
+  }
+}