mcp-server-my-todo

개인 할 일 목록을 위한 최소한의 MCP(Model Context Protocol) 서버이며, SQLite를 기반으로 합니다.

Tools

• 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

서버는 streamable-http 전송을 사용하여 http://0.0.0.0:8000/mcp에서 수신 대기합니다.

환경 변수:

• PORT — 수신 대기할 포트 (기본값 8000)

• TODO_DB_PATH — SQLite 파일 경로 (기본값 todo.db)

MCP 클라이언트를 http://localhost:8000/mcp에 연결하여 시도해 보세요(예: MCP inspector 사용).

uv run mcp dev main.py

Render에 배포

이 저장소에는 Dockerfile과 render.yaml 블루프린트가 포함되어 있으며, 이를 통해 웹 서비스와 /data에 마운트된 1GB 영구 디스크가 프로비저닝됩니다(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

배포 간 영속성이 필요하지 않다면 블루프린트를 건너뛰고 동일한 빌드/시작 명령어로 무료 티어의 기본 Render 웹 서비스를 만들면 됩니다 — 서비스가 재배포되거나 종료될 때마다 할 일 목록은 초기화될 뿐입니다.