MCP TODO Checklist Server

local-only server

The server can only run on the client’s local machine because it depends on local resources.

MCP TODOチェックリスト

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

特徴

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

要件

  • Node.js 18以上
  • NPM 8以上

インストール

方法1: ローカルインストール(開発)

  1. リポジトリをクローンする
cd C:\workspace\mcp git clone (seu-repositório) mcp-mr-checklist cd mcp-mr-checklist
  1. 依存関係をインストールしてコンパイルする
npm install npm run build
  1. 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: グローバルインストール(使用)

  1. パッケージをグローバルにインストールする
npm install -g @hevener/server-todo-checklist
  1. 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参照してください。

ID: z3gwefnnwr