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: Jewei MSSQL 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

🛠️ 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 :

En VSCode, haga clic en el ícono del servidor (☰) en la barra lateral del complemento Cline
Haga clic en el botón "Editar configuración de MCP" (✎)
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

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Related Servers

sqlite-explorer-fastmcp-mcp-server