Todo MCP Server

🚀 Todo MCP サーバー

これは、モデルコンテキストプロトコル（MCP）を使用して構築されたシンプルなタスク管理アプリケーションで、MCP の相互作用をテストおよびデモンストレーションするために使用されます。

📋 概要

このリポジトリには、MCP サーバーとして実装された最小限のタスク管理アプリケーションが含まれています。以下の操作が可能です。

• すべてのタスクをリスト表示する
• 特定のタスクを表示する
• 新しいタスクを追加する
• タスクを削除する
• すべてのタスクをクリアする
• メタデータ付きの構造化されたタスクを作成する

このプロジェクトは、モデルコンテキストプロトコルサーバーとの相互作用をテストするためのテストベッドとして機能し、MCP プロトコルを使用して機能を構築および公開する方法を理解するのに役立ちます。モデルコンテキストプロトコルの詳細については、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 デスクトップアプリケーションまたはその他の MCP 対応アプリケーションに登録されます。

MCP チェッカーを使用してサーバーをテストする場合は、以下のコマンドを使用できます：

mcp dev server.py

これにより、サーバーが起動し、MCP チェッカーインターフェースが付属しているため、テストとデバッグが容易になります。

💻 APIの使用

このサーバーは、以下の MCP リソースとツールを介してインターフェースを公開しています。

リソース

1. すべてのタスクをリスト表示する：

GET todo://list

2. 特定のタスクを表示する：

GET todo://view/{item_idx}

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

ヒント

1. 構造化されたタスクを作成する：

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

このヒントは、優先度と期限付きのタスクをフォーマットするのに役立ちます。パラメータ：

• task_name：タスクの名前/説明
• priority：タスクの優先度（low、medium、high）
• due_date：タスクの期限（オプション）

ツール

1. 新しいタスクを追加する：

add_todo(value: str)

2. タスクを削除する：

remove_todo(item_idx: int)

3. すべてのタスクをクリアする：

clear_todo()

MCP 設定に手動で追加する

このサーバーを MCP 設定に手動で追加する場合は、Claude デスクトップ設定ファイル（通常は ~/.claude-desktop/claude_desktop_config.json または C:\Users\YourUsername\AppData\Roaming\Claude\claude_desktop_config.json）に以下の JSON を追加します：

{
  "mcpServers": {
    "todo": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp",
        server.py
      ]
    }
  }
}

server.py を実際のファイルパスに置き換えてください。

Docker

Docker を使用してサーバーを実行するには、以下のコマンドを実行します：

docker pull ghcr.io/idsulik/todo-mcp-server:latest
docker run -it ghcr.io/idsulik/todo-mcp-server:latest

🤝 貢献

このプロジェクトへのコードマージリクエストを歓迎します！