What can you do with this server?

Summary: This MCP MySQL server lets Claude inspect and query a configured MySQL database in read-only mode. * Test the MySQL connection and return database name/version. * List tables and views. * Describe table columns, indexes, and foreign keys. * Find tables by column name using exact or wildcard patterns. * Sample rows from a table (up to 100) and count rows. * Run read-only SQL queries (SELECT, SHOW, DESCRIBE, EXPLAIN, WITH) with optional row limiting. * It cannot modify, delete, or create data.

Which integrations are available for this server?

Provides tools for testing connections, listing tables, describing table columns, and executing read-only SQL queries (SELECT, SHOW, DESCRIBE, EXPLAIN, WITH) on a MySQL database.

How do I use MCP MySQL?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@MCP MySQL list all tables in the database" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

MCP Database

Permite consultar las bases de datos de soporte (MySQL/osTicket, Oracle, SQL Server, PostgreSQL e Informix) pidiéndoselo a Claude con tus palabras, por ejemplo "dame el reporte de horas de septiembre".

Es solo de lectura: Claude puede consultar, pero no modificar, borrar ni crear datos.

Antes de empezar

Necesitas:

Claude Code, instalado y con tu sesión iniciada (descargar). Instálalo antes de ejecutar el instalador de este proyecto.
Git (descargar).
Acceso a la red de la base de datos (la VPN, si corresponde).
Los datos de conexión de un usuario de solo lectura: servidor, base de datos, usuario y contraseña. Pídeselos a tu responsable.
Solo si vas a usar SQL Server o Informix: el driver ODBC instalado (cómo instalarlo).

No hace falta instalar Python ni tener permisos de administrador: el instalador se encarga de todo.

Related MCP server: MCP MySQL Server

Instalación

1. Descarga el proyecto

Abre una terminal (en Windows, PowerShell) y ejecuta:

git clone https://github.com/EgCooper/MCP-DATABASE.git

Se crea la carpeta MCP-DATABASE. Déjala siempre en el mismo lugar; si algún día la mueves, vuelve a ejecutar el instalador.

2. Ejecuta el instalador

Windows: en la misma terminal, ejecuta:

.\MCP-DATABASE\resources\Scripts\setup_claude_code.cmd

(o haz doble clic en setup_claude_code.cmd, dentro de la carpeta MCP-DATABASE\resources\Scripts).

Linux / macOS:

./MCP-DATABASE/resources/Scripts/setup_claude_code.sh

3. Responde las preguntas

Qué bases vas a usar. Escribe el número de cada una (por ejemplo 1 para MySQL/osTicket, o 1,4 para dos) o presiona Enter para aceptar la sugerida.
Espera la instalación. La primera vez tarda uno o dos minutos.
Ingresa los datos de conexión de cada base. Presiona Enter para mantener el valor que aparece entre corchetes. La contraseña no se ve mientras la escribes; es normal.
El instalador prueba la conexión y deja todo configurado en Claude Code. Al final debes ver algo así:
```
OK: conectado a osticket
OK    mysql: registrado y conectado
```
Si la conexión falla, te muestra el error y te ofrece corregir los datos.

4. Pruébalo

Abre Claude Code (si ya estaba abierto, ciérralo y vuelve a abrirlo) y escribe:

prueba la conexión a mysql

Qué puedo pedir

Escríbele a Claude como le escribirías a un compañero. Por ejemplo:

"Dame el reporte de horas de septiembre de 2026."
"¿Cuántas horas extra y horas compensadas hubo en agosto, por agente?"
"Busca el ticket 123456 y dime su estado."
"¿Qué tablas de la base de osTicket tienen que ver con tickets?"
Si tienes varias bases Oracle: "En la base QA, lista las tablas de clientes."

Cambiar datos o actualizar

Vuelve a ejecutar el instalador (paso 2) cuando necesites:

Cambiar una contraseña u otro dato: responde s cuando te pregunte si quieres cambiar los datos. Lo demás se mantiene con Enter.
Agregar otra base: elígela en el menú.
Instalar una versión nueva: antes, entra a la carpeta y descarga los cambios con cd MCP-DATABASE y git pull.
Mover la carpeta a otro lugar.

Después, reinicia Claude Code.

Si algo falla

Qué ves	Qué hacer
`ERROR` al probar la conexión	Revisa los datos y que estés conectado a la VPN. El instalador te ofrece corregirlos ahí mismo.
`No se encontro Claude Code`	Instala Claude Code, inicia sesión y vuelve a ejecutar el instalador.
Windows: un mensaje sobre "Control de aplicaciones" o Smart App Control	Windows está bloqueando archivos de Python. Pide ayuda a TI (detalles).
Windows: PowerShell no deja ejecutar el instalador	Tu empresa bloquea los scripts por directiva. Pide a TI que lo habilite.
Claude dice que no tiene acceso a la base	En una terminal, ejecuta `claude mcp list`. Si la base aparece con `Failed`, vuelve a ejecutar el instalador.
Linux: el instalador no encuentra Claude Code aunque está instalado	Si usas la terminal de VS Code, prueba desde la terminal del sistema.

Si sigue sin funcionar, envía a tu responsable una captura de lo que muestra el instalador.

Seguridad

Tus datos de conexión se guardan solo en tu equipo, en el archivo .env de la carpeta MCP-DATABASE. No lo compartas ni lo envíes a nadie.
Usa siempre un usuario de base de datos de solo lectura.

Para desarrolladores

El instalador configura las bases en Claude Code. Para usarlas desde otro asistente (Cursor, VS Code, Claude Desktop…), instalar a mano, ver qué hace el instalador paso a paso o conocer las tools disponibles, consulta la documentación técnica.

Available Tools

10 tools

count_rowsC

Count rows in a table.

Args: table_name: Table name.

Inputs: table_name (required). Returns: result

describe_tableC

Describe the columns of a MySQL table.

Args: table_name: Name of the table to inspect.

Inputs: table_name (required). Returns: result

execute_queryA

Execute a read-only SQL query (SELECT, SHOW, DESCRIBE, EXPLAIN, WITH).

Args: query: SQL query to run. limit: Max rows when the query has no LIMIT (1-1000).

Inputs: query (required), limit. Returns: result

find_columnA

Find tables that contain a column name (supports % wildcards).

Args: column_name: Exact name or pattern, e.g. customer_id or %email%.

Inputs: column_name (required). Returns: result

list_foreign_keysA

List foreign keys for one table, or all in the current database.

Args: table_name: Optional table name. Empty = all foreign keys.

Inputs: table_name. Returns: result

list_indexesC

List indexes for a MySQL table.

Args: table_name: Name of the table.

Inputs: table_name (required). Returns: result

list_tablesA

List all tables in the configured MySQL database.

Inputs: no named parameters. Returns: result

list_viewsA

List all views in the configured MySQL database.

Inputs: no named parameters. Returns: result

sample_rowsB

Return sample rows from a table.

Args: table_name: Table name. limit: Max rows (1-100). Default 10.

Inputs: table_name (required), limit. Returns: result

test_connectionA

Test the MySQL connection and return database name and version.

Inputs: no named parameters. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

Deploy Server

Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

TDQS

A3.6/5.0

Scored 2026-09-28 08:45 across 10 tools

Disambiguation4/5

Most tools have clearly distinct purposes (list_tables vs list_views vs describe_table, etc.), but execute_query overlaps with nearly all specialized tools since it can run arbitrary read-only SQL including SHOW, DESCRIBE, and SELECT. The descriptions help, but an agent might still choose execute_query instead of the dedicated tool for some tasks.

Naming Consistency5/5

All tool names follow a consistent snake_case verb_noun pattern (test_connection, list_tables, describe_table, find_column, etc.), making the set highly predictable and readable.

Tool Count5/5

With 10 tools, the server is well-scoped for read-only MySQL introspection and querying. Each tool serves a specific purpose, and the count is neither too thin nor too heavy.

Completeness4/5

The surface covers connection testing, schema listing (tables, views, indexes, foreign keys), column discovery, and data sampling/counting. Minor gaps like retrieving DDL (SHOW CREATE TABLE) or listing triggers/procedures exist, but these can be handled via execute_query.

Maintenance

ActivityActive

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

data
co.thinair
PostgreSQL, MySQL, and SQL Server in one session. 26 read-only MCP tools for AI agents.
Databases Developer Tools
2
https://data.thinair.co/mcp
QueryBear
io.github.spencerpauly
Safe, read-only Postgres and MySQL access for AI agents. Audit log + column-level controls.
Databases RAG Systems
2
https://mcp.querybear.com/mcp
DraxlrA
com.draxlr.api
Draxlr's remote MCP server connects AI assistants to your SQL databases and dashboards. Explore schemas, run read-only queries, manage saved queries and dashboards, and export results, all with row-level security so each user sees only their own data.
Data Visualization Databases Search
1
https://api.draxlr.com/mcp
AgentSQL
io.github.cuipengdba
Guard AI agents' PostgreSQL/MySQL access via MCP: SQL audit, auth, masking, write approval
Databases Security
116
https://demo.agentsql.cn/mcp

Related MCP Servers

MySQL MCP Server
Databases Security Developer Tools
amornpan
F
license
Not graded
quality
D
maintenance
Enables secure interaction with MySQL databases, allowing AI assistants to list tables, read data, and execute SQL queries through a controlled interface.
Updated 2 years ago (2025-03-07 07:21 UTC)
-
MCP MySQL Server
Databases Developer Tools
Iceeeeec
A
license
Not graded
quality
D
maintenance
Enables AI assistants to safely query MySQL databases with read-only access by default, supporting table listing, structure inspection, and SQL queries with optional write operation control.
Updated a year ago (2025-11-06 03:02 UTC)
12 npm
MIT
MySQL ReadOnly MCP Server
Databases Developer Tools
zhaojw-php
A
license
A
quality
D
maintenance
Enables AI assistants to safely query MySQL databases with read-only access, featuring SQL injection protection, connection pooling, and automatic query limits for secure database exploration.
Updated a year ago (2025-12-08 01:56 UTC)
4
130 npm
MIT
Simple MCP MySQL Server
Databases Developer Tools
alexcc4
F
license
Not graded
quality
D
maintenance
Enables AI assistants to securely interact with MySQL databases, including listing tables, viewing schemas, and executing read-only SQL queries through natural language.
Updated 2 years ago (2025-03-09 15:57 UTC)
7
-

MCP Database

Antes de empezar

Instalación

1. Descarga el proyecto

2. Ejecuta el instalador

3. Responde las preguntas

4. Pruébalo

Qué puedo pedir

Cambiar datos o actualizar

Si algo falla

Seguridad

Para desarrolladores

Available Tools

Tool Schema Changelog

TDQS

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

MySQL MCP Server

MCP MySQL Server

MySQL ReadOnly MCP Server

Simple MCP MySQL Server