@sansavision/atlas

Atlas Context Engine — MCP-native context engine for AI coding agents.

This npm package is a thin wrapper around the native atlas and atlas-mcp binaries. The correct binary for your platform is installed automatically via optionalDependencies.

Requirements

• Node.js ≥ 18
• Internet access during install (npm downloads the platform package)

Installation

npm install -g @sansavision/atlas
# or locally in a project
npm install @sansavision/atlas

CLI usage

# Index a repository
atlas index /path/to/repo

# Start the MCP server (stdio transport)
atlas-mcp

# Start the MCP server (HTTP transport on port 8080)
atlas-mcp --port 8080

# Run full help
atlas --help
atlas-mcp --help

Programmatic usage (Node.js)

const { startMcpServer } = require('@sansavision/atlas');

// Spawn atlas-mcp in the current working directory
const server = startMcpServer(['--port', '8080']);
server.on('close', (code) => console.log(`atlas-mcp exited with code ${code}`));

Supported platforms

| Platform | Target triple | |------------------|---------------------------------| | Linux x86_64 | x86_64-unknown-linux-musl | | macOS arm64 | aarch64-apple-darwin | | macOS x86_64 | x86_64-apple-darwin | | Windows x86_64 | x86_64-pc-windows-msvc |

Building from source

See the main repository for Rust build instructions.

License

MIT