mcp-server-my-todo

Минимальный MCP-сервер (Model Context Protocol) для личного списка дел на базе SQLite.

Инструменты

• add_todo(task: str) — добавить новый пункт списка дел

• list_todos(include_done: bool = True) — показать список дел, при необходимости скрывая выполненные

• complete_todo(todo_id: int) — отметить пункт как выполненный

• delete_todo(todo_id: int) — удалить пункт

Related MCP server: Todo MCP Server

Локальный запуск

uv sync
uv run main.py

Сервер слушает http://0.0.0.0:8000/mcp, используя транспорт streamable-http.

Переменные окружения:

• PORT — порт для прослушивания (по умолчанию 8000)

• TODO_DB_PATH — путь к файлу SQLite (по умолчанию todo.db)

Чтобы попробовать, укажите MCP-клиенту адрес http://localhost:8000/mcp, например, с помощью MCP inspector:

uv run mcp dev main.py

Деплой на Render

Этот репозиторий включает Dockerfile и blueprint render.yaml, который собирает его и предоставляет веб-сервис, а также постоянный диск на 1 ГБ, смонтированный в /data (так что файл SQLite переживает деплои и перезапуски — обычная файловая система Render эфемерна, а диски требуют платного типа инстанса, отсюда plan: starter).

1. Запушьте этот репозиторий на GitHub.

2. В Render создайте новый Blueprint и укажите его на репозиторий — он прочитает render.yaml, соберёт Dockerfile и запустит контейнер.

3. После деплоя ваш MCP-эндпоинт будет доступен по адресу https://<your-service>.onrender.com/mcp.

Вы также можете собрать и запустить образ локально, чтобы сначала проверить его:

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

Если вам не нужно сохранять данные между деплоями, вы можете пропустить blueprint и просто создать обычный веб-сервис Render с теми же командами сборки и запуска на бесплатном тарифе — список дел будет просто сбрасываться при каждом передеплое или остановке сервиса.