Database Explorer MCP

Un servidor FastMCP para explorar y consultar de forma segura bases de datos relacionales. La base de datos de desarrollo local es SQLite; SQLAlchemy también admite PostgreSQL y MySQL a través de sus controladores.

Arquitectura

El cliente MCP realiza razonamiento en lenguaje natural y genera SQL. Este servidor expone herramientas de base de datos, valida consultas de solo lectura, las ejecuta y devuelve resultados estructurados.

MCP client LLM -> FastMCP tools -> safety layer -> SQLAlchemy -> database

El servidor no llama a Anthropic, por lo que no se requiere una clave de API de Anthropic.

Related MCP server: nl2sql-mcp

Configuración

Instala uv y, desde este directorio, ejecuta:

uv sync
uv run python tests/seed_test_db.py
uv run pytest

Si uv aún no está en PATH, usa:

py -m uv sync
py -m uv run pytest

La base de datos predeterminada es:

sqlite:///sample.db

Para usar otra base de datos, establece DATABASE_URL antes de iniciar el servidor. Ejemplos:

$env:DATABASE_URL = "sqlite:///C:/data/example.db"
$env:DATABASE_URL = "postgresql+psycopg2://user:password@localhost:5432/example"
$env:DATABASE_URL = "mysql+pymysql://user:password@localhost:3306/example"

Ejecutar el servidor MCP

uv run server.py

La configuración MCP de VS Code que se puede compartir está en .vscode/mcp.json. Inicia el servidor a través de stdio y se puede usar con clientes compatibles con MCP e Inspector.

Para alojamiento remoto, usa Streamable HTTP:

$env:MCP_TRANSPORT = "streamable-http"
$env:MCP_HOST = "0.0.0.0"
$env:MCP_PORT = "8000"
uv run server.py

El despliegue remoto debe proporcionar autenticación y proteger DATABASE_URL mediante su configuración de secretos.

Herramientas

• explore_schema: enumera las tablas o inspecciona una tabla

• execute_query: ejecuta un SELECT seguro de solo lectura

• explain_query: devuelve el plan de ejecución nativo

• validate_schema: informa de las claves primarias faltantes y las claves foráneas sin índice

• suggest_index: sugiere índices a partir de los metadatos de la tabla o de un plan de consulta

• migration_context: proporciona contexto del esquema para la generación de migraciones en el cliente

• validate_migration: valida los scripts UP y DOWN propuestos sin ejecutarlos

Toda ejecución y explicación de consultas pasa por la capa de seguridad. Se rechazan las sentencias de mutación, los comentarios y las sentencias múltiples. Los resultados de las consultas tienen un máximo predeterminado de 100 filas.

Pruebas

uv run pytest

La suite de pruebas utiliza bases de datos SQLite temporales y no requiere credenciales externas ni un servidor de base de datos en ejecución.

Despliegue remoto

Consulta DEPLOYMENT.md para conocer los pasos de despliegue de FastMCP Horizon, los requisitos de la base de datos remota y la lista de verificación de autenticación.