Query database schemas and generate valid SQL for any RDBMS
SchemaCrawler MCP client lets a VS Code AI agent explore a database schema via regex search and readable text output.
17.15.7Add to Favorites
Why it matters
Connect to relational databases to retrieve schema metadata, generate syntactically valid SQL queries, and answer questions about database structure including column naming conventions and table relationships.
Outcomes
What it gets done
Connect to any relational database management system
Retrieve and explore database schema metadata and structure
Generate valid SQL queries for connected databases
Answer questions about column prefixes and naming conventions
Source
Get it from source
Spark does not host a copy of it.
Open sourceReports
Agent outcome reports
No reports yet
Overview
A VS Code MCP client wrapper for the SchemaCrawler AI MCP Server, exposing SchemaCrawler's regex-based schema object search and readable text output to an AI coding agent in Agent mode. Use it when you want a VS Code AI agent to explore and understand a database's schema through SchemaCrawler.
What it does
SchemaCrawler is a free database schema discovery and comprehension tool that can search database schema objects using regular expressions and output schema and data in a readable text format, aimed at data governance use cases. This project is a bare MCP client wrapper that connects to the separate SchemaCrawler AI MCP Server, letting an AI coding assistant work with SchemaCrawler in "Agent" mode inside Visual Studio Code.
When to use - and when NOT to
Use it when you want an AI agent running in VS Code's Agent mode to answer questions about a database's structure - which tables or columns match a pattern, what the schema looks like - by pattern-matching schema objects rather than writing SQL by hand. It is scoped specifically to VS Code's Copilot Chat MCP integration; it is not useful in a client that doesn't support MCP, and it doesn't replace direct use of the SchemaCrawler CLI for users who don't need an AI agent in the loop - that path, along with the rest of this setup, is documented in docs/getting-started.md.
Capabilities
The underlying SchemaCrawler AI MCP Server is distributed as an official Docker-verified image on the Docker MCP Catalog (mcp/schemacrawler-ai), with early-release builds published separately under schemacrawler/schemacrawler-ai. SchemaCrawler's core capability - searching schema objects with regular expressions and producing readable text output of schema and data - is exposed to the AI agent through this MCP integration.
How to install
Install Docker, Docker Compose, and Visual Studio Code, then read Microsoft's "Use MCP servers in VS Code" documentation before cloning this project and opening it in VS Code. Follow the project's own getting-started documentation in its docs/ folder for the remaining setup and Agent-mode configuration steps.
Who it's for
Developers and data engineers who want an AI coding agent in VS Code to explore and understand a database's schema - searching for tables, columns, or other objects by pattern and reviewing readable schema output - as part of a data governance or database-comprehension workflow.
Source README
:star: Star it :arrow_heading_up: if you love it!
SchemaCrawler AI MCP Server: Usage
About
SchemaCrawler is a free database schema discovery and comprehension tool. SchemaCrawler has a good mix of useful features for data governance. You can search for database schema objects using regular expressions, and output the schema and data in a readable text format.
This is a bare project that acts as an MCP client for the SchemaCrawler AI MCP Server for use in "Agent" mode. You can find documentation on how to use the server here.
The SchemaCrawler AI MCP Server Docker image is available at schemacrawler/schemacrawler-ai.
Prerequisites
- Install supporting software
- Docker
- Docker Compose
- Visual Studio Code
- Read Use MCP servers in VS Code
- Clone this project, and open it in Visual Studio Code
Getting Started
Refer to the getting started documentation, and more documentation in docs/.
FAQ
Common questions
Discussion
Questions & comments · 0
Sign In Sign in to leave a comment.