mcp-server-my-todo

Ein minimaler MCP-Server (Model Context Protocol) für eine persönliche Todo-Liste, basierend auf SQLite.

Werkzeuge

• add_todo(task: str) — einen neuen Todo-Eintrag hinzufügen

• list_todos(include_done: bool = True) — Todos auflisten, optional abgeschlossene ausblenden

• complete_todo(todo_id: int) — einen Todo als erledigt markieren

• delete_todo(todo_id: int) — einen Todo löschen

Related MCP server: Todo MCP Server

Lokal ausführen

uv sync
uv run main.py

Der Server lauscht auf http://0.0.0.0:8000/mcp und verwendet den streamable-http-Transport.

Umgebungsvariablen:

• PORT — Port, auf dem der Server lauscht (Standard: 8000)

• TODO_DB_PATH — Pfad zur SQLite-Datei (Standard: todo.db)

Richten Sie einen MCP-Client auf http://localhost:8000/mcp aus, um es auszuprobieren, z. B. mit dem MCP inspector:

uv run mcp dev main.py

Auf Render bereitstellen

Dieses Repository enthält ein Dockerfile und ein render.yaml-Blueprint, das es baut und einen Webdienst sowie eine 1-GB-persistente Festplatte bereitstellt, die unter /data gemountet ist (damit die SQLite-Datei Deployments/Neustarts übersteht — das reguläre Dateisystem von Render ist flüchtig, und Festplatten einen kostenpflichtigen Instanztyp erfordern, daher plan: starter).

1. Pushen Sie dieses Repository auf GitHub.

2. Erstellen Sie in Render ein neues Blueprint und richten Sie es auf das Repository aus — es wird render.yaml lesen, das Dockerfile bauen und den Container ausführen.

3. Sobald die Bereitstellung abgeschlossen ist, lautet Ihr MCP-Endpunkt https://<your-service>.onrender.com/mcp.

Sie können das Image auch lokal bauen/ausführen, um es zunächst zu testen:

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

Wenn Sie keine Persistenz über Deployments hinweg benötigen, können Sie das Blueprint überspringen und einfach einen normalen Render-Webdienst mit denselben Build-/Start-Befehlen im kostenlosen Tarif erstellen — die Todo-Liste wird einfach zurückgesetzt, sobald der Dienst erneut bereitgestellt oder heruntergefahren wird.