MCP Todo Checklist Server

🚀 MCP TODO リストチェックサーバー

Claude Desktopのタスク管理に使用される、タスクリスト管理システムを実装したMCP（Model Context Protocol）サーバーです。このシステムは、複数のタスクリストの作成と管理をサポートし、優先度、期限、タグなどの機能を備えています。

🚀 クイックスタート

MCP TODO リストチェックサーバーは、Claude Desktopのタスク管理に役立つシステムです。以下の手順に従って、サーバーをセットアップしてください。

✨ 主な機能

• ✅ 複数のタスクリストの作成と管理
• 📌 優先度（低、中、高）のサポート
• 📅 タスクの期限設定
• 🏷️ 分類整理のためのタグシステム
• 👥 ユーザー間でのタスクリストの共有
• 💾 ファイルシステムにデータを永続的に保存

📦 インストール

インストール要件

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

インストール方法

方法 1：ローカルインストール（開発用途）

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

cd C:\workspace\mcp
git clone (your-repository) mcp-mr-checklist
cd mcp-mr-checklist

2. 依存関係をインストールしてビルドします。

npm install
npm run build

3. 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

2. claude_desktop_config.jsonを設定します。

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

💻 使用例

基本的な使用法

/todo_create {
  "name": "工作任务",
  "tasks": [
    { "title": "项目报告", "priority": "高", "deadline": "2023-10-31" },
    { "title": "团队会议", "priority": "中", "deadline": "2023-11-01" }
  ]
}

利用可能なコマンド

• /todo_create：新しいタスクリストを作成します。
• /todo_read：すべてのタスクリストを読み取ります。
• /todo_update：既存のタスクリストを更新します。
• /todo_delete：指定されたタスクリストを削除します。

📚 ドキュメント

プロジェクト構造

.
├── src/
│   ├── index.ts                 # エントリーファイル
│   └── checklist.ts            # リスト管理ロジック
├── schemas/                   # データ検証スキーマ
│   └── checklist.schema.ts     # リストデータスキーマ
└── dist/
    └── index.js               # ビルド出力

設定オプション

claude_desktop_config.jsonでは、以下の設定が可能です。

• storagePath：データを保存するディレクトリのパス
• commandTimeout：コマンド実行の最大タイムアウト時間（デフォルトはミリ秒で60000）

🔧 技術詳細

• TypeScript
• Model Context Protocol SDK
• Zod（データ検証）
• ファイルベースのストレージシステム

📄 ライセンス

このプロジェクトはMITライセンスに基づいて配布されています。詳細については、LICENSEファイルを参照してください。