mcp-db-wrapper-example

El foro.sh starter de base de datos: un servidor MCP que envuelve una pequeña base de datos SQL. Viene con una tabla de demostración (notes) para que haya algo que consultar de inmediato, y herramientas que tu agente de IA de codificación puede usar para leerla y escribirla.

¿Abriendo esto en Claude Code? No hay nada que instalar. El repositorio incluye las habilidades que tu agente necesita en .claude/skills/: cómo desplegar este servidor, y cómo añadir herramientas que valgan lo que cuesta a un modelo llevarlas.

Antes de desplegar

Sin ninguna configuración, esto se ejecuta en un archivo SQLite local que se borra en cada reinicio y redeploy - válido para probarlo, no para datos que te importen.

Para conservar los datos, establece DATABASE_URL como secreto en la pestaña de Secretos de tu proyecto (una URL sqlite:/// que apunte a un archivo en un volumen que controles). Para un tipo diferente de base de datos, consulta Almacenamiento más abajo.

Related MCP server: sqlite-mcp

Herramientas

Hazlo tuyo

Esto es un punto de partida, no un producto terminado. Abre este repositorio en Claude Code (u otro agente de IA de codificación) y pídele que:

• añada las tablas que tu proyecto realmente necesita

• añada herramientas para las cosas específicas que quieras hacer con tus datos — no solo query/insert en bruto — por ejemplo, find_cliente(correo), log_evento(...)

• lo apunte a una base de datos real una vez que tengas una (consulta Almacenamiento más abajo)

No necesitas conocer FastMCP ni el Model Context Protocol para hacer nada de esto — describe lo que quieres en lenguaje natural y deja que el agente escriba el código.

Almacenamiento

El tipo de base de datos se declara en pyproject.toml:

[tool.mcp-db-wrapper]
database = "sqlite"

server.py lo lee y se niega a iniciar si DATABASE_URL no coincide (por ejemplo, una URL no sqlite:/// mientras database = "sqlite"), ya que el tipo es configuración, no algo inferido de la URL que esté establecida.

Por defecto, sin ningún secreto DATABASE_URL, esto se ejecuta en /tmp/db.sqlite3, creado automáticamente, sin configuración requerida, y se borra en cada reinicio y redeploy (la plataforma no monta volúmenes persistentes). Establece DATABASE_URL a una ruta sqlite:/// en un volumen que controles para conservar los datos. Para un tipo diferente de base de datos (por ejemplo, Postgres), pide a tu agente de codificación que cambie al controlador correspondiente y actualice database arriba para que coincida.

Ejecútalo localmente

uv run server.py

El servidor habla MCP sobre HTTP transmisible en http://localhost:8000/mcp (establece PORT para cambiar el puerto — el mismo nombre que foro inyecta cuando te despliega).

Despliégalo

Su pyproject.toml es todo lo que foro.sh necesita, así que este repositorio se despliega tal cual: inicia sesión, elige este repositorio, despliega.