Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Inicia sesión con Google para escribir reseñas.Prototipo · se actualiza cada 30 min
PopNx MCPServidores MCP para quienes usan IA · en palabras sencillas

Read Only Local Mysql MCP Server

✓ hove.capital

de hovecapitalversión 0.1.1i★ 7iSe ejecuta en tu computadoraSitio oficial ↗
Nombre en el registrocapital.hove/read-only-local-mysql-mcp-server

Cómo instalar

What it does

MCP server for read-only MySQL database queries in Claude Desktop

  • Connects Se ejecuta en tu computadora
  • Account or key No key needed
  • Category Bases de datos y conjuntos de datos

Úsalo junto con

Skills que enseñan a la IA este tipo de trabajo; funcionan junto a este

timesfm

TimesFM (Time Series Foundation Model) is a pretrained time-series foundation model developed by Google Research for time-series forecasting.

de google-research★ 35.6381 skills

Skill · Guía de trabajo

Shadowbroker

Open-source intelligence for the global theater. Track everything from the corporate/private jets of the wealthy, and spy satellites, to seismic events in one unified interface. Hook an AI agent up to have it parse through data and find previously unseen correlations. The knowledge is available to…

de BigBodyCobain★ 11.6051 skills

Skill · Guía de trabajo

google-maps-scraper

scrape data from Google Maps. Extracts data such as the name, address, phone number, website URL, rating, reviews number, latitude and longitude, reviews,email and more for each place

de gosom★ 82361 skills

Skill · Guía de trabajo

Por qué está en este puesto

Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes

Popularidad11/80Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20
Actualidad12/12Puntuación completa con una versión o cambio de código en 30 días
Sigue respondiendo0/8El endpoint en la nube respondió en la última revisión
Puntuación de uso23/100

Calidad: Pasó 3/3 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)

Instalación

Elige la app de IA que usas y copia la configuración.

Que tu IA lo instale con una frase

Instala Read Only Local Mysql MCP Server. Sigue https://mcp.popnx.com/i/capital-hove-read-only-local-mysql-mcp-server.md, enséñame los comandos y espera mi OK antes de ejecutarlos.

Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA

Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 13 nov 2026

Primero: ¿qué IA usas?

Elige tu app y los pasos aparecen abajo.

Funciona con Claude, pero hay que preparar algo antes

Instala Node.js en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil

Que la IA lo instale

Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server Read Only Local Mysql MCP Server para Claude en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "read-only-local-mysql": { "command": "npx", "args": [ "-y", "@hovecapital/read-only-mysql-mcp-server" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de Read Only Local Mysql MCP Server aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Node.js (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    node -v
    • Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl

    Abrir la página de descarga de Node.js ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v

    Se instala una vez y sirve para todo lo que usa Node.js

  2. Abre el archivo de configuración de la app de Claude de escritorio

    SettingsDeveloperEdit Config

  3. Pega esta configuración y guarda el archivo

    {
      "mcpServers": {
        "read-only-local-mysql": {
          "command": "npx",
          "args": [
            "-y",
            "@hovecapital/read-only-mysql-mcp-server"
          ]
        }
      }
    }
  4. Cierra Claude y vuelve a abrirlo

  5. Pruébalo

    Usa Read Only Local Mysql MCP Server y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude dice que está usando Read Only Local Mysql MCP Server o muestra una herramienta de Read Only Local Mysql MCP Server en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

ChatGPT todavía no puede conectar Read Only Local Mysql MCP Server

Read Only Local Mysql MCP Server se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web

Lo que puedes hacer en su lugar

A · Usa una app que pueda conectar Read Only Local Mysql MCP Server

  • Instala Node.js en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
  • Instala Node.js en tu computadora primero (una sola vez)
  • Instala Node.js en tu computadora primero (una sola vez)
  • Instala Node.js en tu computadora primero (una sola vez)

B · Otros en Bases de datos y conjuntos de datos que funcionan con ChatGPT

Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave

Funciona con Claude Code, pero hay que preparar algo antes

Instala Node.js en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server Read Only Local Mysql MCP Server para Claude Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user read-only-local-mysql -- npx -y @hovecapital/read-only-mysql-mcp-server 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de Read Only Local Mysql MCP Server aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Node.js (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    node -v
    • Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl

    Abrir la página de descarga de Node.js ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v

    Se instala una vez y sirve para todo lo que usa Node.js

  2. Abre la Terminal

    Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell

  3. Pega este comando y pulsa Enter

    claude mcp add --scope user read-only-local-mysql -- npx -y @hovecapital/read-only-mysql-mcp-server
  4. Escribe /mcp en Claude Code

    Deberías ver Read Only Local Mysql MCP Server en la lista como conectado

  5. Pruébalo

    Usa Read Only Local Mysql MCP Server y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude Code dice que está usando Read Only Local Mysql MCP Server o muestra una herramienta de Read Only Local Mysql MCP Server en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor, pero hay que preparar algo antes

Instala Node.js en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server Read Only Local Mysql MCP Server para Cursor en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "read-only-local-mysql": { "command": "npx", "args": [ "-y", "@hovecapital/read-only-mysql-mcp-server" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de Read Only Local Mysql MCP Server aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Node.js (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    node -v
    • Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl

    Abrir la página de descarga de Node.js ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v

    Se instala una vez y sirve para todo lo que usa Node.js

  2. Pulsa este botón para abrir Cursor

    Abrir en Cursor

    Cursor te pedirá confirmar; pulsa Install

  3. Abre el chat de IA de Cursor en modo Agent

  4. Pruébalo

    Usa Read Only Local Mysql MCP Server y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Cursor dice que está usando Read Only Local Mysql MCP Server o muestra una herramienta de Read Only Local Mysql MCP Server en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code, pero hay que preparar algo antes

Instala Node.js en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server Read Only Local Mysql MCP Server para VS Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "read-only-local-mysql": { "type": "stdio", "command": "npx", "args": [ "-y", "@hovecapital/read-only-mysql-mcp-server" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de Read Only Local Mysql MCP Server aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Node.js (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    node -v
    • Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl

    Abrir la página de descarga de Node.js ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v

    Se instala una vez y sirve para todo lo que usa Node.js

  2. Pulsa este botón para abrir VS Code

    Abrir en VS Code

    VS Code te pedirá confirmar; pulsa Install

  3. Abre el chat de IA de VS Code en modo Agent

  4. Pruébalo

    Usa Read Only Local Mysql MCP Server y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si VS Code dice que está usando Read Only Local Mysql MCP Server o muestra una herramienta de Read Only Local Mysql MCP Server en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa Read Only Local Mysql MCP Server💬 Conversación →
Para desarrolladores: comandos de Terminal y configuración JSON

Instalado en tu computadora

Claude Code

claude mcp add --scope user read-only-local-mysql -- npx -y @hovecapital/read-only-mysql-mcp-server

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "read-only-local-mysql": {
      "command": "npx",
      "args": [
        "-y",
        "@hovecapital/read-only-mysql-mcp-server"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "read-only-local-mysql": {
      "command": "npx",
      "args": [
        "-y",
        "@hovecapital/read-only-mysql-mcp-server"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "read-only-local-mysql": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@hovecapital/read-only-mysql-mcp-server"
      ]
    }
  }
}

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

De un vistazo

Descargas por semanai
233/sem
Dominio verificado
✓ hove.capital
Conexión
Se ejecuta en tu computadora
Última versióni
0.1.1
Publicado en el registroi
17 feb 2026
Último cambio de códigoi
13 nov 2026
Creador
hovecapital
Paquetes
npm: @hovecapital/read-only-mysql-mcp-server
Sitio web
hove.capital
Estado en el registro
Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se ejecutan en tu computadora en

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Todas las apps, con ventajas y desventajas →

Qué puede hacer

Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 19 nov 2026

  • ✓ Superada

    El creador coincide con el repo

    El nombre en el registro se verificó con el dominio hove.capital (el registro comprueba quién es dueño del dominio)

  • ✓ Superada

    Sigue en mantenimiento

    Último cambio de código: hace 6 días

  • ✓ Superada

    Tiene licencia

    Usa MIT

  • – No aplica

    El endpoint responde

    Este se ejecuta en tu computadora; no hay endpoint en internet

  • – No aplica

    Inicio de sesión con OAuth

    Se ejecuta en tu computadora y usa ajustes locales en su lugar

  • … Aún sin revisar

    Sin instrucciones ocultas en las descripciones de herramientas

    Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet

Vulnerabilidades publicadas (OSV.dev)

Sin entradas en OSV.dev para @hovecapital/read-only-mysql-mcp-server@0.1.1

Solo revisa esta versión del paquete, no todas sus dependencias · revisado 15 nov 2026

Qué revisamos → · JSON

Creadores: pedir otra revisión o avisar de un dato erróneo
Para autores: añade una insignia a tu README

Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/capital-hove-read-only-local-mysql-mcp-server.svg)](https://mcp.popnx.com/en/servers/capital-hove-read-only-local-mysql-mcp-server)

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión para escribir una reseña

Comparado con otros en Bases de datos y conjuntos de datosi

  • Más estrellas que el 91% de los otros 1235 servidores de esta categoría
  • Publicado en el registro más recientemente que el 3% de los otros 1235 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 99% de los otros 1235 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro Read Only Local Mysql MCP Server?

Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

El registro no indica ninguna clave obligatoria, aunque algunos servidores te piden iniciar sesión la primera vez que los usas.

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez hace 6 días, y la última versión (0.1.1) llegó al registro hace 9 meses.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Node.js en tu computadora.

¿Qué puedo usar en su lugar?

En la misma categoría: QueryWeaver, Supabase, Neon, DBCode, Keboola MCP

Alternativas parecidas

Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

QueryWeaver

An MCP server for Text2SQL: transforms natural language into SQL using graph schema understanding.

de FalkorDBEn crecimiento★ 1,1 milActualizado hace 14 meses

Se ejecuta en tu computadora✓ falkordb.com

Supabase

MCP server for interacting with the Supabase platform

de supabaseMuy usado↓ 245,5 mil/sem★ 3 mil Estrellas de todo el repositorioActualizado ayer

Computadora o nube✓ del servicio · supabase.com

Neon

Official Neon MCP server for managing Neon projects and Lakebase Postgres databases.

de neondatabaseEn crecimiento★ 666Actualizado hace 13 días

Se ejecuta en la nube✓ del servicio · neon.com

DBCode

Query and explore 100+ databases through your DBCode connections.

de dbcodeioInicial↓ 118/sem★ 368 Estrellas de todo el repositorioActualizado hace 2 meses

Se ejecuta en tu computadora✓ del servicio · dbcode.io

Keboola MCP

Connect your AI assistants to Keboola and expose your data, transformations, SQL queries, ...

de keboolaEn crecimiento↓ 1,4 mil/sem★ 84Actualizado hace 3 días

Computadora o nube✓ del servicio · keboola.com
Comparado con otros parecidos
Este
Read Only Local Mysql MCP Server
QueryWeaverSupabaseNeonDBCodeKeboola MCP
Dónde se ejecutaSe instala en tu equipoSe instala en tu equipoEn la nube o instalado en tu equipoFunciona en la nube, sin instalar nadaSe instala en tu equipoEn la nube o instalado en tu equipo
Necesita claveNoNoSíNoNoNo
Se añade con + en ClaudeNoNoSíSíNoNo
Revisiones básicas3/33/35/55/52/35/5
LicenciaMITAGPL-3.0Apache-2.0MITNOASSERTIONMIT
PrecioSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registro

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

MySQL MCP Server

A Model Context Protocol (MCP) server that enables Claude Desktop to interact with MySQL databases through natural language queries.

Features

  • Execute read-only SQL queries through Claude Desktop
  • Dynamic connection configuration — connect to any MySQL database at runtime via connection string
  • Built-in security with query validation (SELECT, WITH, SHOW, DESCRIBE and EXPLAIN only, one statement, no comments) plus a server-side read-only transaction
  • Easy integration with Claude Desktop
  • JSON formatted query results
  • Environment-based configuration for database credentials

Quick Start

For Claude Code Users (Recommended - Easiest Method)
claude mcp add mysql -s user -- npx -y @hovecapital/read-only-mysql-mcp-server@latest

Then set your database environment variables:

export DB_HOST=localhost

export DB_PORT=3306 export DB_DATABASE=your_database_name export DB_USERNAME=your_username export DB_PASSWORD=your_password

Done! Restart Claude Code and ask: "What tables are in my database?"

For Claude Desktop Users (Manual Configuration)

1. Open your config file:

# macOS

open ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows

notepad %APPDATA%\Claude\claude_desktop_config.json

2. Add this configuration:

{

"mcpServers": { "mysql": { "command": "npx", "args": ["-y", "@hovecapital/read-only-mysql-mcp-server@latest"], "env": { "DB_HOST": "localhost", "DB_PORT": "3306", "DB_DATABASE": "your_database_name", "DB_USERNAME": "your_username", "DB_PASSWORD": "your_password" } } } }

3. Save, restart Claude Desktop, and test!

Prerequisites

  • Node.js (v16 or higher) - If using mise, update the command path accordingly
  • MySQL database server
  • Claude Desktop application

Installation

Option 1: Install from MCP Registry (Recommended)

This server is published in the Model Context Protocol Registry as capital.hove/read-only-local-mysql-mcp-server.

Method A: Claude Code CLI (Easiest!)
claude mcp add mysql -s user -- npx -y @hovecapital/read-only-mysql-mcp-server@latest

Then configure your database credentials using environment variables. Restart Claude Code and you're done!

Benefits:

  • One command installation
  • No manual JSON editing
  • Automatic configuration
Method B: Manual JSON Configuration

For Claude Desktop:

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{

"mcpServers": { "mysql": { "command": "npx", "args": ["-y", "@hovecapital/read-only-mysql-mcp-server@latest"], "env": { "DB_HOST": "localhost", "DB_PORT": "3306", "DB_DATABASE": "your_database_name", "DB_USERNAME": "your_username", "DB_PASSWORD": "your_password" } } } }

For Claude Code:

Edit ~/.config/claude-code/settings.json (macOS/Linux) or %APPDATA%\claude-code\settings.json (Windows):

{

"mcp": { "servers": { "mysql": { "command": "npx", "args": ["-y", "@hovecapital/read-only-mysql-mcp-server@latest"], "env": { "DB_HOST": "localhost", "DB_PORT": "3306", "DB_DATABASE": "your_database_name", "DB_USERNAME": "your_username", "DB_PASSWORD": "your_password" } } } } }

Option 2: Install from npm
npm install -g @hovecapital/read-only-mysql-mcp-server
Option 3: Installation with Claude Code

If you're using Claude Code, you can easily install this MCP server:

# Clone the repository

git clone https://github.com/hovecapital/read-only-local-mysql-mcp-server.git cd read-only-local-mysql-mcp-server

Install dependencies and build

npm install npm run build

Then configure Claude Code by adding to your MCP settings.

Option 4: Manual Installation
1. Clone or Download

Save the repository to a directory on your system:

mkdir ~/mcp-servers/mysql

cd ~/mcp-servers/mysql git clone https://github.com/hovecapital/read-only-local-mysql-mcp-server.git .

2. Install Dependencies
npm install

npm run build

Configuration

Note: If you installed via Option 1 (MCP Registry with npx), you've already configured everything! This section is for users who chose Options 2, 3, or 4 (npm or manual installation).

Claude Code Configuration

If you're using Claude Code with a manual installation, add the MySQL server to your MCP settings:

  1. Open your Claude Code settings (typically in ~/.config/claude-code/settings.json on macOS/Linux or %APPDATA%\claude-code\settings.json on Windows)
  1. Add the MySQL MCP server configuration:
{

"mcp": { "servers": { "mysql": { "command": "node", "args": ["/absolute/path/to/read-only-local-mysql-mcp-server/dist/index.js"], "env": { "DB_HOST": "localhost", "DB_PORT": "3306", "DB_DATABASE": "your_database_name", "DB_USERNAME": "your_username", "DB_PASSWORD": "your_password" } } } } }

  1. Restart Claude Code for the changes to take effect.
Claude Desktop Configuration

If you're using Claude Desktop with a manual installation, open your Claude Desktop configuration file:

macOS:

~/Library/Application Support/Claude/claude_desktop_config.json

Windows:

%APPDATA%\Claude\claude_desktop_config.json

Add the MySQL server configuration:

{

"mcpServers": { "mysql": { "command": "node", "args": ["/absolute/path/to/read-only-local-mysql-mcp-server/dist/index.js"], "env": { "DB_HOST": "localhost", "DB_PORT": "3306", "DB_DATABASE": "your_database_name", "DB_USERNAME": "your_username", "DB_PASSWORD": "your_password" } } } }

Using mise for Node.js

If you're using mise for Node.js version management, make sure to use the full path to the Node.js executable in your configuration.

Environment Variables
VariableDescriptionDefault
DB_HOSTMySQL server hostnamemysql
DB_PORTMySQL server port3306
DB_DATABASEDatabase namedatabase
DB_USERNAMEMySQL usernameroot
DB_PASSWORDMySQL password(empty)
DB_ALLOWED_HOSTSComma-separated extra hosts a connection string may point at. DB_HOST and loopback are always allowed.(empty)

Usage

  1. Restart Claude Desktop after updating the configuration
  2. Start chatting with Claude about your database
Example Queries
"Show me all tables in my database"

"What's the structure of the users table?" "Get the first 10 records from the products table" "How many orders were placed last month?" "Show me users with email addresses ending in @gmail.com"

Claude will automatically convert your natural language requests into appropriate SQL queries and execute them against your database.

Tools

connect

Connect to a MySQL database using a connection string. The connection persists for subsequent queries until changed or disconnected.

Parameters:

ParameterRequiredDescription
connectionStringYesMySQL connection string (e.g., mysql://user:password@host:port/database)
disconnect

Disconnect from the current runtime database and revert to the default environment-configured connection. Takes no parameters.

query

Run a read-only SQL query against the currently connected database.

Parameters:

ParameterRequiredDescription
sqlYesSQL query to execute (read-only)
connectionStringNoMySQL connection string to override the current connection for this query only

Dynamic Connection

The server supports switching databases at runtime without restarting. Connection priority:

  1. Per-query `connectionString` — overrides everything for a single query
  2. Runtime connection (from connect tool) — persists until disconnect is called
  3. Environment variables — the default fallback

Connection string format:

mysql://username:password@hostname:port/database_name

The hostname must be DB_HOST, a loopback address, or listed in DB_ALLOWED_HOSTS. Any other host is rejected before a connection is attempted, so the tools cannot be used to probe the network. Connection failures return a generic message and the real error is written to stderr.

Example workflow:

1. connect → mysql://analyst:pass@prod-db:3306/analytics
  1. query → SELECT COUNT(*) FROM events
  2. query → SELECT * FROM users LIMIT 5 (uses the same analytics connection)
  3. query → SELECT * FROM orders LIMIT 5, connectionString: mysql://analyst:pass@prod-db:3306/sales (one-off override — does not change the stored connection)
  4. disconnect → reverts to env var defaults

Security Features

Read-Only Operations

Queries are checked in two layers:

  1. Query validation — the statement must start with SELECT, WITH, SHOW, DESCRIBE or EXPLAIN, contain a single statement, contain no comments, and must not contain state-changing keywords anywhere (for example UPDATE, DELETE, INTO OUTFILE, INTO DUMPFILE, LOAD_FILE, FOR UPDATE, EXPLAIN ANALYZE). String literals and backtick identifiers are ignored by this check.
  2. Server-side read-only transaction — every query runs after SET SESSION TRANSACTION READ ONLY, so MySQL itself rejects writes, including writes made inside stored functions.

Use a MySQL user with only SELECT privileges as well (see below). The validation blocks the known bypasses, but the database privilege is the final guarantee.

Recommended Database Setup

For enhanced security, create a dedicated read-only user for the MCP server:

-- Create a read-only user

CREATE USER 'claude_readonly'@'localhost' IDENTIFIED BY 'secure_password';

-- Grant only SELECT permissions on your specific database GRANT SELECT ON your_database_name.* TO 'claude_readonly'@'localhost';

-- Apply the changes FLUSH PRIVILEGES;

Troubleshooting

Connection Issues
  1. Verify MySQL is running: Check if your MySQL server is active
  2. Check credentials: Ensure username/password are correct
  3. Network connectivity: Confirm Claude Desktop can reach your MySQL server
Configuration Issues
  1. Restart required: Always restart Claude Desktop after configuration changes
  2. Path accuracy: Ensure the absolute path to dist/index.js is correct
  3. JSON syntax: Validate your claude_desktop_config.json format
Debug Mode

To see server logs, you can run the server manually:

node dist/index.js

File Structure

~/mcp-servers/mysql/

├── src/ │ └── index.ts ├── dist/ │ ├── index.js │ └── index.d.ts ├── package.json ├── tsconfig.json └── node_modules/

Dependencies

  • @modelcontextprotocol/sdk: MCP protocol implementation
  • mysql2: Modern MySQL client for Node.js with Promise support

Contributing

Feel free to submit issues and enhancement requests!

License

This project is open source and available under the MIT License.

Support

If you encounter issues:

  1. Check the troubleshooting section above
  2. Verify your MySQL connection independently

3.

Solo se muestra el principio; lee el resto en el repo