Todo List MCP Server

プレーンなJSONファイルを、MCP互換クライアント（Claude Desktop、Claude Code、Cursorなど）が代わりに読み取り・管理できるTODOリストに変換する、小さなModel Context Protocolサーバーです。

機能

5つのツールと1つのリソースを公開します：

データは server.py と同じ場所にある todos.json に保存されるため、再起動後も保持されます。

Related MCP server: MCP Todo Server

セットアップ

# 1. Clone / copy this folder
cd todo-mcp

# 2. Create a virtual environment and install dependencies
python3 -m venv venv
source venv/bin/activate   # Windows: venv\Scripts\activate
pip install -r requirements.txt

# 3. Run it directly to sanity-check it starts (Ctrl+C to stop)
python server.py

MCPクライアントに接続する

Claude Desktop

これを claude_desktop_config.json に追加します（設定 → 開発者 → 設定を編集）：

{
  "mcpServers": {
    "todo-list": {
      "command": "/absolute/path/to/todo-mcp/venv/bin/python",
      "args": ["/absolute/path/to/todo-mcp/server.py"]
    }
  }
}

Claude Desktopを再起動すると、ツールピッカー（ハンマーアイコン）でTODOツールが利用できるようになります。試してみてください：「'finish MCP ticket' を高優先度のTODOとして追加して、保留中のものをすべて表示して」

MCP Inspector（ローカルデバッグ用）

npx @modelcontextprotocol/inspector python server.py

これによりブラウザUIが開き、各ツールを手動で呼び出して、生のJSON-RPCリクエスト/レスポンスを確認できます。クライアントとサーバー間で実際にやり取りされる内容を理解するのに最適な方法です。

Smitheryへのデプロイ

1. このフォルダを公開GitHubリポジトリにプッシュします（server.py、pyproject.toml、requirements.txt、smithery.yaml が必要です）。

2. smithery.ai にアクセスし、New Server → GitHubリポジトリを接続します。

3. Smitheryは smithery.yaml を読み取ってサーバーの起動方法（stdio経由の python server.py）を把握し、自動的にビルド/デプロイします。

4. デプロイが完了すると、誰でもSmitheryのリスティングページから自分のMCPクライアントに直接追加できます。相手側でのローカル設定は不要です。

実装に関するメモ

公式のMCP Python SDKとFastMCPを使用して構築されています。FastMCPは@mcp.tool()デコレータを介してプレーンなPython関数をMCPツールに変換します。型ヒントとdocstringは自動的にツールのJSONスキーマと説明になり、クライアントモデルはそれを読み取って各ツールをいつ・どのように呼び出すかを判断します。