Skip to content
Chris LeRoux edited this page Dec 13, 2025 · 1 revision

MySQL MCP Server

Enterprise-grade MySQL MCP Server with OAuth 2.0 authentication, connection pooling & tool filtering – TypeScript Edition

GitHub Docker Pulls License: MIT Version


What is mysql-mcp?

A MySQL MCP Server that enables AI assistants (Claude, Cursor, etc.) to interact with MySQL databases through the Model Context Protocol. It provides 106 specialized tools for database operations, performance analysis, and administration.

πŸš€ Quick Links

Resource Description
Installation Prerequisites and setup guide
Configuration Environment variables, MCP client configs, connection scenarios
Tool-Filtering Reduce tool count for IDE limits
Tool-Reference Complete list of all 106 tools

πŸ“¦ Deployment Options

  • NPM/Local: Clone and build from source
  • Docker: docker run -i --rm writenotenow/mysql-mcp:latest

πŸ”₯ Core Features

  • 106 MySQL Tools across 15 categories
  • 4 AI-Powered Prompts for guided workflows
  • Connection Pooling via mysql2
  • Tool Filtering to stay within IDE limits
  • OAuth 2.0 enterprise authentication support
  • Docker Deployment with multi-arch images

πŸ› οΈ Tool Categories

Category Tools Description
Core 8 CRUD, schema, tables, indexes
Transactions 7 BEGIN, COMMIT, ROLLBACK, savepoints
JSON 12 JSON_EXTRACT, JSON_SET, etc.
Text 6 REGEXP, LIKE, SOUNDEX
FULLTEXT 4 Natural language search
Performance 8 EXPLAIN, query analysis
Optimization 4 Index hints, recommendations
Admin 6 OPTIMIZE, ANALYZE, CHECK
Monitoring 7 PROCESSLIST, status variables
Backup 4 Export, import, mysqldump
Replication 5 Master/slave, binlog
Partitioning 4 Partition management
Router 9 MySQL Router REST API
ProxySQL 12 Proxy management
Shell 10 MySQL Shell utilities

πŸ“š Advanced Topics

Topic Description
MySQL-Router Configure MySQL Router tool access
ProxySQL Configure ProxySQL admin access
MySQL-Shell Configure MySQL Shell integration

πŸ”— External Links


Last updated: December 2025 β€’ Version 1.0.0

Clone this wiki locally