MCP server/database

MCP Atlas MCP Server

An MCP server for Ariga Atlas, enabling AI assistants to manage migrations.

★ 1mpreziuso/mcp-atlas ↗by mpreziusoupdated
1

Add it to Claude Code

claude mcp add mcp-atlas -- npx -y @mpreziuso/mcp-atlas
2

Make your agent remember this setup

mcp-atlas's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.

npx conare@latest

Free · one command · indexes the sessions already on disk. Set up in the browser instead →

What it does

  • Apply pending migration files to a database
  • Generate new migration files by comparing current state to desired schema
  • Run analysis on migration directory to detect issues
  • Report current migration status of a database
  • Validate migration directory integrity and consistency

Tools 6

migrate-applyApply pending migration files to a database
migrate-diffGenerate new migration files by comparing current state to desired schema
migrate-lintRun analysis on migration directory to detect issues
migrate-newCreate new empty migration files
migrate-statusReport current migration status of a database
migrate-validateValidate migration directory integrity and consistency

Try it

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
Original README from mpreziuso/mcp-atlas

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 [email protected]

Repository

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

Frequently Asked Questions

What are the key features of MCP Atlas?

Apply pending migration files to a database. Generate new migration files by comparing current state to desired schema. Run analysis on migration directory to detect issues. Report current migration status of a database. Validate migration directory integrity and consistency.

What can I use MCP Atlas for?

Automating database schema updates during development cycles. Validating migration scripts for consistency before deployment. Quickly checking the current migration status of a database via natural language. Generating migration files based on schema changes.

How do I install MCP Atlas?

Install MCP Atlas by running: npx -y @mpreziuso/mcp-atlas

What MCP clients work with MCP Atlas?

MCP Atlas works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Conare · memory for coding agents

Turn this server into reusable context

Keep MCP Atlas docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Set up free$npx conare@latest