MCP TODOチェックリスト

Claude Desktop 上のタスク管理用のチェックリストシステムを展開する MCP サーバー。このシステムでは、優先順位、期日、タグをサポートし、複数のタスクリストを作成および管理できます。

特徴

✅ 複数のToDoリストの作成と管理
📌 優先度サポート（低、中、高）
📅 タスクの期限
🏷️ 整理のためのタグシステム
👥 ユーザー間でリストを共有する
💾 永続的なファイルシステムストレージ

Related MCP server: Coding Todo Server

要件

Node.js 18以上
NPM 8以上

インストール

方法1: ローカルインストール（開発）

リポジトリをクローンする

cd C:\workspace\mcp
git clone (seu-repositório) mcp-mr-checklist
cd mcp-mr-checklist

依存関係をインストールしてコンパイルする

npm install
npm run build

claude_desktop_config.jsonで設定します:

{
  "servers": {
    "todo-checklist": {
      "type": "command",
      "command": "node dist/index.js",
      "cwd": "C:\\workspace\\mcp\\mcp-mr-checklist",
      "config": {
        "storagePath": "./data",
        "commandTimeout": 60000
      }
    }
  }
}

方法2: グローバルインストール（使用）

パッケージをグローバルにインストールする

npm install -g @hevener/server-todo-checklist

claude_desktop_config.jsonで設定します:

{
  "servers": {
    "todo-checklist": {
      "type": "command",
      "command": "mcp-server-todo-checklist",
      "config": {
        "storagePath": "C:\\Users\\SEU_USUARIO\\AppData\\Local\\claude-todo-checklist",
        "commandTimeout": 60000
      }
    }
  }
}

クロードで利用可能なコマンド

新しいリストを作成する

/todo_create {
  "title": "Minha Lista",
  "description": "Descrição opcional da lista"
}

タスクを追加する

/todo_add {
  "listTitle": "Minha Lista",
  "taskTitle": "Nova Tarefa",
  "priority": "high",
  "dueDate": "2024-01-20",
  "tags": ["trabalho", "urgente"]
}

すべてのリストを一覧表示する

/todo_list

リストの詳細を表示する

/todo_show {
  "listTitle": "Minha Lista"
}

タスクを完了としてマークする

/todo_complete {
  "listTitle": "Minha Lista",
  "taskTitle": "Nova Tarefa"
}

プロジェクト構造

src/
├── index.ts           # Ponto de entrada do servidor
├── commands.ts        # Definição dos comandos disponíveis
├── service/          
│   └── ChecklistService.ts  # Lógica de negócio
├── storage/
│   └── index.ts      # Implementação do armazenamento
└── types/
    ├── ChecklistItem.ts     # Tipos para itens
    └── index.ts            # Tipos principais

データ構造

チェックリスト

interface Checklist {
  id: string;
  title: string;
  description?: string;
  items: ChecklistItem[];
  owner: string;
  shared?: string[];
  createdAt: Date;
  updatedAt: Date;
}

タスク（チェックリスト項目）

interface ChecklistItem {
  id: string;
  title: string;
  description?: string;
  completed: boolean;
  dueDate?: Date;
  priority: 'low' | 'medium' | 'high';
  tags: string[];
  createdAt: Date;
  updatedAt: Date;
}

開発スクリプト

# Compilar o projeto
npm run build

# Executar em modo desenvolvimento
npm run dev

# Observar alterações e recompilar
npm run watch

# Iniciar o servidor compilado
npm start

設定

claude_desktop_config.jsonファイルでは、以下を設定できます。

storagePath : データが保存されるディレクトリ
commandTimeout : コマンド実行時間の最大値（ミリ秒）（デフォルト: 60000）

使用される技術

タイプスクリプト
モデルコンテキストプロトコルSDK
Zod（データ検証）
ファイルベースのストレージシステム

ライセンス

MIT ライセンスに基づいて配布されます。詳細については、 LICENSE参照してください。

MCP TODO Checklist Server