shibayu36/mysql-schema-explorer-mcp

This is a Model Context Protocol (MCP) server that provides compressed schema information for MySQL databases.
This MCP server is useful when the schema dump file does not fit in the context size because you are using a large database schema.
https://github.com/user-attachments/assets/0cecef84-cd70-4f84-95cb-01c6ec7c9ac7
## Provided Tools
List Tables (listtables)
Lists all table information in the specified database. Includes table name, comment, primary key, unique key, and foreign key information.
Parameters
dbName: The name of the database to retrieve information from (not required when DBNAME environment variable is set)
Describe Tables (describetables)
Displays detailed information for specific tables in the specified database. Provides formatted information such as column definitions, key constraints, and indexes.
Parameters
dbName: The name of the database to retrieve information from (not required when DBNAME environment variable is set)
tableNames: An array of table names to retrieve detailed information for
## Quick Start
1. Configure mcp.json
json
"mcpServers": {
"mysql-schema-explorer-mcp": {
"command": "docker",
"args": ["run", "-i", "--rm", "--pull", "always", "--network=host",
"-e", "DBHOST=127.0.0.1",
"-e", "DBPORT=3306",
"-e", "DBUSER=root",
"-e", "DBPASSWORD=yourpassword",
"ghcr.io/shibayu36/mysql-schema-explorer-mcp:latest"
If using Claude Code:
bash
claude mcp add mysql-schema-explorer-mcp -- docker run -i --rm --pull always --network=host \
-e DBHOST=127.0.0.1 \
-e DBUSER=root \
-e DBPASSWORD=yourpassword \
-e DBPORT=3306 \
ghcr.io/shibayu36/mysql-schema-explorer-mcp:latest
2. Execute SQL generation using the agent
Example: Using the structure of the ecshop database, list the names of the 3 most recently ordered products by the user shibayu36.
## Usage
### Fixing to a Specific Database
When accessing only one database, you can set the DBNAME environment variable to avoid specifying the database name each time.
json
"mcpServers": {
"mysql-schema-explorer-mcp": {
"command": "docker",
"args": ["run", "-i", "--rm", "--network=host",
"-e", "DBHOST=127.0.0.1",
"-e", "DBPORT=3306",
"-e", "DBUSER=root",
"-e", "DBPASSWORD=yourpassword",
"-e", "DBNAME=ecshop",
"ghcr.io/shibayu36/mysql-schema-explorer-mcp:latest"