Atlas

An MCP (Model Context Protocol) server for Ariga Atlas, enabling AI assistants to interact with Atlas migration tools through the Model Context Protocol.

What is this?

This package provides a bridge between AI assistants (like Claude) and Atlas, allowing them to manage database migrations, validate schemas, and perform other database-related operations using Atlas commands.

Features

• migrate-apply: Apply pending migration files to a database
• migrate-diff: Generate new migration files by comparing current state to desired schema
• migrate-lint: Run analysis on migration directory to detect issues
• migrate-new: Create new empty migration files
• migrate-status: Report current migration status of a database
• migrate-validate: Validate migration directory integrity and consistency

Prerequisites

• Atlas CLI must be installed and available in your PATH
• Node.js 18 or higher

Configuration

Add this server to your MCP client configuration. For Claude Desktop, add to your config file:

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "atlas": {
      "command": "npx",
      "args": ["-y", "@mpreziuso/mcp-atlas"]
    }
  }
}

The -y flag automatically installs or updates the package without prompting.

Usage

Once configured, your AI assistant can use Atlas commands through the MCP protocol. Example interactions:

• "Check the migration status of my database"
• "Create a new migration file"
• "Apply pending migrations to the database"
• "Validate the migration directory"
• "Generate a migration diff from my schema"

Example Commands

The MCP server wraps these Atlas CLI commands:

• atlas migrate apply - Apply migrations
• atlas migrate diff - Generate migration diffs
• atlas migrate lint - Lint migration files
• atlas migrate new - Create new migration
• atlas migrate status - Check migration status
• atlas migrate validate - Validate migrations

License

MIT

Author

Michele Preziuso [email protected]

Repository

https://github.com/mpreziuso/mcp-atlas