Servidor MCP del lector MariaDB

Este proyecto es un servidor de Protocolo de Contexto de Modelo (MCP) para explorar e interactuar con bases de datos MariaDB. Este servidor proporciona herramientas que permiten a los asistentes de IA como Cline acceder a las bases de datos de MariaDB y consultar información.

función

Este servidor MCP proporciona las siguientes herramientas:

• list_databases : Devuelve una lista de todas las bases de datos accesibles.

• list_tables : Devuelve una lista de todas las tablas en la base de datos especificada.

  • Entrada: database (cadena, obligatoria) - El nombre de la base de datos para la que se recuperará una lista de tablas.

• get_table_schema : Devuelve el esquema (definición de columna) de la tabla especificada.

  • aporte:

    • database (cadena, obligatoria) - El nombre de la base de datos a la que pertenece la tabla.

    • table (cadena, obligatoria): el nombre de la tabla para la que se consultará el esquema.

• query_table : recupera datos de una tabla especificada. De forma predeterminada, devuelve las primeras 100 filas.

  • aporte:

    • database (cadena, obligatoria) - El nombre de la base de datos a la que pertenece la tabla.

    • table (cadena, obligatoria) - El nombre de la tabla de la que se recuperarán los datos.

    • limit (número, opcional) - El número máximo de filas a devolver (predeterminado: 100).

Related MCP server: MCP MariaDB Server

configuración

Para utilizar este servidor, debe clonar el repositorio de GitHub y registrar la información del servidor en el archivo de configuración de su cliente MCP (por ejemplo, la extensión VS Code). Este repositorio contiene un ejecutable prediseñado ( build/index.js ) que no requiere ningún paso de compilación separado.

1. Clonar repositorio: clona este repositorio en una ubicación de tu elección.

   git clone https://github.com/moosin76/mcp_server_mariadb_reader.git

2. Modificar el archivo de configuración de MCP:

Configuración de ejemplo:

{
  "mcpServers": {
    "mcp_server_mariadb_reader": {
      "command": "node",
      "args": ["<클론된 저장소 경로>/build/index.js"], // 클론된 저장소 내 build/index.js 파일 경로
      "env": {
        "MARIADB_HOST": "YOUR_DB_HOST",         // MariaDB 호스트 주소
        "MARIADB_PORT": "YOUR_DB_PORT",         // MariaDB 포트 번호 (예: "3306")
        "MARIADB_USER": "YOUR_DB_USER",         // MariaDB 사용자 이름
        "MARIADB_PASSWORD": "YOUR_DB_PASSWORD", // MariaDB 비밀번호
        "MARIADB_DATABASE": "YOUR_DEFAULT_DB"   // (선택) 기본 데이터베이스 이름
      },
      "disabled": false,
      "autoApprove": []
    }
    // 다른 MCP 서버 설정...
  }
}

precaución:

• Debe cambiar <클론된 저장소 경로> a la ruta local donde realmente clonó el repositorio. (p. ej. C:/Users/YourUser/Documents/GitHub/mcp_server_mariadb_reader )

• Necesitará modificar la información de conexión de MariaDB en env para que coincida con su entorno real.

Desarrollo (al modificar el código fuente)

Este repositorio contiene los archivos compilados, por lo que no es necesario seguir los pasos a continuación para usar el servidor. Para modificar el código fuente (directorio src ) directamente y aplicar los cambios, siga estos pasos:

1. Instalación de dependencias (primera vez o al cambiar package.json ):

   npm install

2. Construir después de la corrección:

   npm run build

   • Este comando compila el código TypeScript en el directorio src en código JavaScript en build .

3. (Opcional) Detectar cambios durante el desarrollo y compilar automáticamente:

   npm run watch

Licencia

Este proyecto se distribuye bajo la licencia [Ingresar información de licencia].