-
securityF
license-
qualityEnables secure interaction with MySQL databases, allowing AI assistants to list tables, read data, and execute SQL queries through a controlled interface.
Last updated -
Servidor MCP de acceso a bases de datos MariaDB/MySQL
Este servidor MCP proporciona acceso a bases de datos MariaDB / MySQL.
Permite:
Lista de bases de datos disponibles
Listar tablas en una base de datos
Describir esquemas de tablas
Ejecutar consultas SQL
Características de seguridad
Acceso de solo lectura. Predeterminado : SELECCIONAR, MOSTRAR, DESCRIBIR y EXPLICAR.
Validación de consultas : evita la inyección de SQL y bloquea cualquier intento de modificación de datos
Tiempo de espera de consulta : evita que las consultas de larga duración consuman recursos
Límite de filas : evita la devolución excesiva de datos
Instalación
Opción 1: Construir desde la fuente
# Clone the repository
git clone https://github.com/bretoreta/mariadb-mcp-server.git
cd mariadb-mcp-server
# Install dependencies and build
pnpm install
pnpm run build
2. Configurar variables de entorno
El servidor requiere las siguientes variables de entorno:
MARIADB_HOST: Nombre de host del servidor de base de datos
MARIADB_PORT: Puerto del servidor de base de datos (predeterminado: 3306)
MARIADB_USER: Nombre de usuario de la base de datos
MARIADB_PASSWORD: Contraseña de la base de datos
MARIADB_DATABASE: Nombre de la base de datos predeterminada (opcional)
MARIADB_ALLOW_INSERT: falso
MARIADB_ALLOW_UPDATE: falso
MARIADB_ALLOW_DELETE: falso
TIEMPO DE ESPERA DE MARIADB: 10000 ms
LÍMITE DE FILAS DE MARIADB: 1000
3. Agregar a la configuración de MCP
Agregue la siguiente configuración a su archivo de configuración de MCP:
Si lo construiste desde la fuente:
{
"mcpServers": {
"mariadb": {
"command": "node",
"args": ["/path/to/mariadb-mcp-server/dist/index.js"],
"env": {
"MARIADB_HOST": "your-host",
"MARIADB_PORT": "3306",
"MARIADB_USER": "your-user",
"MARIADB_PASSWORD": "your-password",
"MARIADB_DATABASE": "your-default-database",
"MARIADB_ALLOW_INSERT": "false",
"MARIADB_ALLOW_UPDATE": "false",
"MARIADB_ALLOW_DELETE": "false",
"MARIADB_TIMEOUT_MS": "10000",
"MARIADB_ROW_LIMIT": "1000",
},
"disabled": false,
"autoApprove": []
}
}
}
Herramientas disponibles
lista_bases_de_datos
Enumera todas las bases de datos accesibles en el servidor MariaDB/MySQL. Parámetros : Ninguno.
Ejemplo :
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"sessionId": "session_id from /sse call",
"name": "list_databases"
}
}
listas_de_tablas
Enumera todas las tablas de una base de datos especificada.
Parámetros :
database(opcional): nombre de la base de datos (usa el predeterminado si no se especifica)
Ejemplo :
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"sessionId": "session_id from /sse call",
"name": "list_tables",
"database": "my_database_name"
}
}
describe_tabla
Muestra el esquema de una tabla específica.
Parámetros :
database(opcional): nombre de la base de datos (usa el predeterminado si no se especifica)table(obligatorio): Nombre de la tabla
Ejemplo :
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"sessionId": "session_id from /sse call",
"name": "describe_table",
"database": "my_database_name",
"table": "my_table_name"
}
}
ejecutar_consulta
Ejecuta una consulta SQL.
Parámetros :
query(obligatoria): consulta SQLdatabase(opcional): nombre de la base de datos (usa el predeterminado si no se especifica)
Ejemplo :
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"sessionId": "session_id from /sse call",
"name": "execute_query",
"query": "SELECT * FROM my_table LIMIT 10"
}
}
Pruebas
El servidor prueba automáticamente MariaDB para verificar la funcionalidad con su configuración de MariaDB:
Solución de problemas
Si encuentra problemas:
Verifique los registros del servidor para ver si hay mensajes de error
Verifique sus credenciales de MariaDB y los detalles de conexión
Asegúrese de que su usuario de MariaDB tenga los permisos adecuados
Compruebe que su consulta sea de solo lectura y tenga el formato correcto
Inspiración https://github.com/rjsalgado/mariadb-mcp-server
Licencia
Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Proporciona acceso seguro y de solo lectura a las bases de datos MariaDB/MySQL, lo que permite a los usuarios enumerar bases de datos, explorar esquemas de tablas y ejecutar consultas SQL con medidas de seguridad integradas.
Related Resources
Related MCP Servers
- -securityAlicense-qualityA server that provides LLMs with read-only access to MySQL databases, allowing them to inspect database schemas and execute read-only queries.Last updated -209MIT License
- -securityAlicense-qualityProvides secure access to MySQL databases for AI assistants, enabling safe SQL queries, table information retrieval, and data insertion with built-in security protections.Last updated -2882MIT License
yooztech_mcp_mysqlofficial
-securityAlicense-qualityEnables secure read-only access to MySQL databases with automatic database inference from project context. Provides safe querying capabilities with built-in security features like parameterized queries, whitelisting, and rate limiting.Last updated -1MIT License