mcp-server-my-todo

個人用Todoリストのための最小限のMCP（Model Context Protocol）サーバーで、SQLiteをバックエンドにしています。

ツール

• add_todo(task: str) — 新しいTodo項目を追加します

• list_todos(include_done: bool = True) — Todoを一覧表示します（完了済みを非表示にすることもできます）

• complete_todo(todo_id: int) — Todoを完了としてマークします

• delete_todo(todo_id: int) — Todoを削除します

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 と、それをビルドしてウェブサービスと /data にマウントされた1GBの永続ディスクをプロビジョニングする render.yaml ブループリントが含まれています（SQLiteファイルがデプロイ/再起動後も維持されるためです。Renderの通常のファイルシステムは一時的であり、ディスクには有料のインスタンスタイプが必要なため、plan: starter となっています）。

1. このリポジトリをGitHubにプッシュします。

2. Renderで新しい ブループリント を作成し、リポジトリを指定します。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ウェブサービスを作成するだけで構いません。サービスが再デプロイまたは停止するたびに、Todoリストはリセットされます。