MCP 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 mpreziuso@kaosdynamics.com

Repository

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