Todo MCP Server

Todo MCP サーバー

MCP（Model Context Protocol）サーバーを使用して構築された、MCP のやり取りをテストおよびデモするためのシンプルな Todo アプリケーションです。

概要

このリポジトリには、MCP サーバーとして実装された最小限の Todo アプリケーションが含まれています。次の操作ができます。

• すべての Todo 項目を一覧表示する
• 特定の Todo 項目を表示する
• 新しい Todo 項目を追加する
• Todo 項目を削除する
• すべての Todo 項目を消去する
• メタデータ付きの構造化された Todo タスクを作成する

このプロジェクトは、Model Context Protocol サーバーとのやり取りをテストし、MCP プロトコルを通じて機能を構築・公開する方法を理解するためのテストベッドとして機能します。Model Context Protocol の詳細については、modelcontextprotocol.io をご覧ください。

必要条件

• Python 3.10+
• uv（Python パッケージインストーラー）

インストール

1. リポジトリをクローンします。

git clone https://github.com/idsulik/todo-mcp-server.git
cd todo-mcp-server

2. uv を使用して依存関係をインストールします。

uv pip install -e .

MCP サーバーリストへの追加

このサーバーを MCP サーバーリストに追加するには、次のコマンドを使用します。

mcp install server.py --name "Todo MCP"

これにより、Claude Desktop アプリまたはその他の MCP 対応アプリケーションにサーバーが登録されます。

また、MCP Inspector でサーバーをテストする場合は、次のコマンドを使用できます。

mcp dev server.py

サーバーが MCP Inspector インターフェースとともに起動し、簡単にテストやデバッグを行えます。

API の使用方法

このサーバーは、次の MCP リソースとツールを公開します。

リソース

1. すべての Todo 項目を一覧表示します。

GET todo://list

2. 特定の Todo 項目を表示します。

GET todo://view/{item_idx}

item_idx は、表示する項目のインデックスです。

プロンプト

1. 構造化された Todo タスクを作成します。

create_task(task_name: str, priority: str = "medium", due_date: str = "")

このプロンプトは、優先度と期限を含む Todo タスクの形式を整えるのに役立ちます。パラメーター：

• task_name：タスクの名前／説明
• priority：タスクの優先度（low、medium、high）
• due_date：タスクの期限（任意）

ツール

1. 新しい Todo 項目を追加します。

add_todo(value: str)

2. Todo 項目を削除します。

remove_todo(item_idx: int)

3. すべての Todo 項目を消去します。

clear_todo()

MCP 設定への手動追加

MCP 設定にサーバーを手動で追加する場合は、次の JSON を Claude Desktop の設定ファイルに追加できます（通常、Mac/Linux では ~/.claude-desktop/claude_desktop_config.json、Windows では C:\Users\YourUsername\AppData\Roaming\Claude\claude_desktop_config.json にあります）。

{
  "mcpServers": {
    "todo": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "/path/to/your/server.py"
      ]
    }
  }
}

/path/to/your/server.py を server.py ファイルの絶対パスに置き換えてください。相対パスではなく、必ず絶対パスを使用してください。

Docker の使用

ローカルに何もインストールせずに、Docker を使用してこの MCP サーバーを実行することもできます。Claude Desktop の設定に次の内容を追加します。

{
  "mcpServers": {
    "todo": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "idsulik/todo-mcp-server"
      ]
    }
  }
}

Docker イメージがシステムに存在しない場合、Docker Hub から自動的に取得されます。

コントリビューション

コントリビューションを歓迎します。お気軽に Pull Request を送信してください。