Servidor MCP de SQLite Explorer

Un servidor MCP que proporciona acceso seguro de solo lectura a bases de datos SQLite mediante el Protocolo de Contexto de Modelo (MCP). Este servidor está desarrollado con el framework FastMCP, que permite a los LLM explorar y consultar bases de datos SQLite con funciones de seguridad integradas y validación de consultas.

📋 Requisitos del sistema

• Python 3.6+

• Archivo de base de datos SQLite (ruta especificada mediante variable de entorno)

Related MCP server: sqlite-mcp-server

📦 Dependencias

Instalar todas las dependencias necesarias:

# Using pip
pip install -r requirements.txt

Paquetes requeridos

• fastmcp : Marco para crear servidores de Protocolo de Contexto de Modelo

Todas las dependencias se especifican en requirements.txt para una fácil instalación.

📑 Índice de contenidos

• Requisitos del sistema

• Dependencias

• Herramientas MCP

• Empezando

• Opciones de instalación

  • Escritorio de Claude

  • Complemento Cline de VSCode

• Características de seguridad

• Documentación de desarrollo

• Variables de entorno

🛠️ Herramientas MCP

El servidor expone las siguientes herramientas a los LLM:

consulta_de_lectura

Ejecuta una consulta SELECT en la base de datos con validaciones de seguridad integradas. Características:

• Validación y saneamiento de consultas

• Soporte de enlace de parámetros

• Aplicación del límite de filas

• Resultados formateados como diccionarios

listas_de_tablas

Enumere todas las tablas disponibles en la base de datos con sus nombres.

describe_tabla

Obtenga información detallada del esquema para una tabla específica, que incluye:

• Nombres y tipos de columnas

• Restricciones NULL

• Valores predeterminados

• Información de clave principal

🚀 Primeros pasos

Clonar el repositorio:

git clone https://github.com/hannesrudolph/sqlite-explorer-fastmcp-mcp-server.git
cd sqlite-explorer-fastmcp-mcp-server

📦 Opciones de instalación

Puedes instalar este servidor MCP en Claude Desktop o en el plugin Cline de VSCode. Elige la opción que mejor se adapte a tus necesidades.

Opción 1: Instalar para Claude Desktop

Instalar usando FastMCP:

fastmcp install sqlite_explorer.py --name "SQLite Explorer" -e SQLITE_DB_PATH=/path/to/db

Reemplace /path/to/db con la ruta a su archivo de base de datos SQLite.

Opción 2: Instalar el complemento Cline VSCode

Para utilizar este servidor con el complemento Cline VSCode :

1. En VSCode, haga clic en el ícono del servidor (☰) en la barra lateral del complemento Cline

2. Haga clic en el botón "Editar configuración de MCP" (✎)

3. Agregue la siguiente configuración al archivo de configuración:

{
  "sqlite-explorer": {
    "command": "uv",
    "args": [
      "run",
      "--with",
      "fastmcp",
      "--with",
      "uvicorn",
      "fastmcp",
      "run",
      "/path/to/repo/sqlite_explorer.py"
    ],
    "env": {
      "SQLITE_DB_PATH": "/path/to/your/database.db"
    }
  }
}

Reemplazar:

• /path/to/repo con la ruta completa a donde clonó este repositorio (por ejemplo, /Users/username/Projects/sqlite-explorer-fastmcp-mcp-server )

• /path/to/your/database.db con la ruta completa a su archivo de base de datos SQLite

🔒 Características de seguridad

• Acceso de solo lectura a bases de datos SQLite

• Validación y saneamiento de consultas

• Vinculación de parámetros para la ejecución segura de consultas

• Aplicación del límite de filas

• Supresión de la salida de progreso para respuestas JSON limpias

📚 Documentación de desarrollo

El repositorio incluye archivos de documentación para el desarrollo:

• mcp-documentation.txt : contiene documentación completa sobre la implementación del servidor MCP y el uso del marco FastMCP.

Esta documentación sirve como contexto durante el desarrollo de funciones y se puede utilizar con LLM para ayudar en el desarrollo.

⚙️ Variables de entorno

Se deben configurar las siguientes variables de entorno:

• SQLITE_DB_PATH : Ruta completa al archivo de base de datos SQLite que desea explorar