mysql
Execute read-only SQL queries against multiple MySQL databases. Use when: (1) querying MySQL databases, (2) exploring database schemas/tables, (3) running SELECT queries for data analysis, (4) checking database contents. Supports multiple database connections with descriptions for intelligent auto-s
By sanjay3290 · 391 installs
npx skills add sanjay3290/ai-skills --skill mysql
Source repository · Upstream listing
MySQL Read Only Query Skill
Execute safe, read only queries against configured MySQL databases.
Requirements
Python 3.8+
mysql connector python: pip install r requirements.txt
Setup
Create connections.json in the skill directory or ~/.config/claude/mysql connections.json .
Security : Set file permissions to 600 since it contains credentials:
Config Fields
Field Required Description
name Yes Identifier for the database (case insensitive)
description Yes What data this database contains (used for auto selection)
host Yes Database hostname
port No Port number (default: 3306)
database Yes Database name
user Yes Username
password Yes Password
ssl disabled No Set to true to disable SSL (default: false)
ssl ca No Path to CA certificate file
ssl cert No Path to client certificate file
ssl key No Path to client private key file
Usage
List configured databases
Query a database
List tables
Show schema
Limit results
Database Selection
Match user intent to database description :
User asks about Look for description containing
users, accounts users, accounts, customers
orders, sales orders, transactions, sales
analytics, metrics analytics, metrics, reports
logs, events logs, events, audit
If unclear, run list and ask user which database.
Safety Features
Read only session : Connection uses MySQL SET SESSION TRANSACTION READ ONLY (primary protection)
Query validation : Only SELECT, SHOW, DESCRIBE, EXPLAIN, WITH queries allowed
Single statement : Multiple statements per query rejected
SSL support : Configurable SSL with CA, client cert, and key support
Query timeout : 30 second max execution time enforced (MySQL 5.7.8+)
Memory protection : Max 10,000 rows per query to prevent OOM
Column width cap : 100 char max per column for readable output
Credential sanitization : Error messages don't leak passwords
Troubleshooting
Error Solution
Config not found Create connections.json in skill directory
Authentication failed Check username/password in config
Connection timeout Verify host/port, check firewall/VPN
SSL error Try "ssl disabled": true for local databases
Permission warning Run chmod 600 connections.json
max execution time not supported Upgrade to MySQL 5.7.8+ or MariaDB 10.1.1+
Exit Codes
0 : Success
1 : Error (config missing, auth failed, invalid query, database error)
Workflow
1. Run list to show available databases
2. Match user intent to database description
3. Run tables or schema to explore structure
4. Execute query with appropriate LIMIT