mcp-server-my-todo

Un servidor MCP (Model Context Protocol) mínimo para una lista de tareas personal, respaldado por SQLite.

Herramientas

• add_todo(task: str) — añade un nuevo elemento de tareas

• list_todos(include_done: bool = True) — lista las tareas, opcionalmente ocultando las completadas

• complete_todo(todo_id: int) — marca una tarea como completada

• delete_todo(todo_id: int) — elimina una tarea

Related MCP server: Todo MCP Server

Ejecutar localmente

uv sync
uv run main.py

El servidor escucha en http://0.0.0.0:8000/mcp usando el transporte streamable-http.

Variables de entorno:

• PORT — puerto en el que escuchar (por defecto 8000)

• TODO_DB_PATH — ruta al archivo SQLite (por defecto todo.db)

Apunta un cliente MCP a http://localhost:8000/mcp para probarlo, por ejemplo con el inspector MCP:

uv run mcp dev main.py

Desplegar en Render

Este repositorio incluye un Dockerfile y un blueprint render.yaml que lo compila y aprovisiona un servicio web más un disco persistente de 1GB montado en /data (para que el archivo SQLite sobreviva a despliegues/reinicios — el sistema de archivos normal de Render es efímero, y los discos requieren un tipo de instancia de pago, de ahí plan: starter).

1. Sube este repositorio a GitHub.

2. En Render, crea un nuevo Blueprint y apúntalo al repositorio — leerá render.yaml, compilará el Dockerfile y ejecutará el contenedor.

3. Una vez desplegado, tu endpoint MCP es https://<your-service>.onrender.com/mcp.

También puedes compilar/ejecutar la imagen localmente para comprobarla primero:

docker build -t mcp-server-my-todo .
docker run --rm -p 8000:8000 mcp-server-my-todo

Si no necesitas persistencia entre despliegues, puedes omitir el blueprint y simplemente crear un servicio web de Render normal con los mismos comandos de compilación/inicio en el nivel gratuito — la lista de tareas se restablecerá cada vez que el servicio se vuelva a desplegar o se apague.