hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

Provides safe, read-only access to SQLite databases through tools like read_query, list_tables, and describe_table

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)

📦 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 :

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

Un servidor MCP que proporciona acceso seguro de solo lectura a bases de datos SQLite a través de 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.