Tasks Organizer

Cursorエージェントの計画を構造化されたMarkdownタスクリストに変換し、コードリポジトリ内で整理するMCPサーバー

開発者ツール知識管理と記憶 #タスク管理 #AI協力 #Markdownツール #開発支援 .Python

rating : 2.5 points

downloads : 28

update time : 2025-04-28

MCPタスクオーガナイザーとは？

MCPタスクオーガナイザーは、AIが生成した計画を追跡するのに役立つツールです。これらの計画を実行可能なタスクリストに変換し、コードリポジトリ内で整理して管理することができます。

MCPタスクオーガナイザーの使い方は？

簡単なコマンドを使用することで、タスクリストを簡単に作成、更新、完了させることができます。わずか数ステップで、効率的なプロジェクト計画を実現できます。

適用シナリオ

頻繁にタスクの進捗を更新し、追跡する必要があるチームや個人開発者に適しています。特に、ソフトウェア開発における機能リファクタリングや新機能の追加などの分野に最適です。

主要機能

タスクの自動抽出Cursorエージェントが生成した計画から自動的にタスクを識別し、抽出します。

タスクフォルダの整理コードリポジトリ内に専用の`.tasks`フォルダを作成して、タスクリストを保存します。

タスク名の規範化説明的なファイル名（例：'refactor - authentication.md'）を使用して、迅速な検索を容易にします。

タスク状態のマーキング完了したタスクをマークすることができ、自動的に接頭辞'✅'が付けられます。

Markdown形式の整形美しいMarkdown形式でタスクリストを表示します。

タスクの分類管理内容を概要、具体的な実施詳細、次の行動に分けて管理します。

利点と制限

利点

作業効率を向上させ、タスク追跡プロセスを簡素化します。

複数のプラットフォームとの統合をサポートし、デバイスを越えた協力を容易にします。

タスクリストの保守と更新が容易です。

制限

Python環境のインストールに依存しているため、初期設定コストが増える可能性があります。

一部の複雑な計画に対して、タスクを完全に正確に抽出できない場合があります。

使い方

MCPタスクオーガナイザーのインストール

オペレーティングシステムに合ったインストール方法を選択し、インストールスクリプトを実行します。

クライアントの設定

Claude for Desktopの設定ファイルを変更し、MCPサーバーのアドレスを指定します。

タスクリストの作成

計画内容を入力し、タイトルと記述子を指定してタスクリストを生成します。

タスク状態の更新

完了したタスクをマークして、タスクリストを更新します。

タスクの完了状況の確認

すべてのタスクが完了したことを確認すると、システムが自動的に完了としてマークします。

使用例

例一：認証システムのリファクタリングCursorエージェントが生成した認証システムのリファクタリング計画をタスクリストに変換します。

例二：データベース移行データベース移行計画をタスクリストに変換し、段階的にタスクを完了させます。

よくある質問

MCPタスクオーガナイザーの使い始め方は？

タスクリストを手動で編集できますか？

タスクの抽出が不完全な場合はどうすればいいですか？

🚀 MCP タスクオーガナイザー

このMCPサーバーは、Cursorのエージェント計画を構造化されたMarkdownタスクリストに変換し、それをあなたのリポジトリに整理します。このサーバーを使用することで、AIが生成した計画や提案を実行可能な規範として追跡することができます。

✨ 主な機能

Cursorのエージェント計画から自動的にタスクを抽出する
リポジトリ内に .tasks フォルダを作成してタスク管理を実現する
識別しやすいように記述的なファイル名（例：“refactor-authentication.md”）を使用する
完了したタスクリストに自動的に ✅ 接頭辞を付ける
計画を正しいMarkdown構造で整形する
内容を概要、実装詳細、後続の手順に整理する
Claude for Desktopや他のMCPクライアントと統合する

📦 インストール

前提条件

Python 3.10 以上
pipまたはその他のPythonパッケージマネージャー

クイックインストール

Unixベースのシステム（macOS、Linux）の場合：

# リポジトリをクローンする
git clone https://github.com/yourusername/mcp-tasks-organizer.git
cd mcp-tasks-organizer

# インストールスクリプトを実行する
./install.sh

Windowsの場合：

# リポジトリをクローンする
git clone https://github.com/yourusername/mcp-tasks-organizer.git
cd mcp-tasks-organizer

# インストールスクリプトを実行する
.install.bat

手動インストール

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

git clone https://github.com/yourusername/mcp-tasks-organizer.git
cd mcp-tasks-organizer

仮想環境を作成してアクティブ化する（オプションだが推奨）：
- macOS/Linuxの場合：
```
python -m venv venv
source venv/bin/activate
```
- Windowsの場合：
```
python -m venv venv
.\venv\Scripts\activate
```
依存関係をインストールする：
```
pip install -r requirements.txt
```
サーバーを起動する：
```
python app.py
```

💻 使用例

基本的な使用法

ツールリスト

convert_plan_to_tasks: 計画テキストをタスクリストに変換する。
mark_task_complete: タスクリスト内の特定のタスクを完了としてマークする。
check_all_tasks_complete: タスクリスト内のすべてのタスクが完了しているかを確認する。
list_task_files: .tasks ディレクトリ内のすべてのタスクファイルをリストする。

サンプルワークフロー

エージェントが認証システムの変更提案を行う
この計画をタスクリストに変換する: convert_plan_to_tasks(plan_text, "Auth System Refactor", "auth-refactor")
タスクは .tasks/auth-refactor.md に保存される
タスクを完了したら、それらをマークする: mark_task_complete("auth-refactor", 1)
すべてのタスクが完了したら: check_all_tasks_complete("auth-refactor")
ファイルは .tasks/✅auth-refactor.md としてリネームされる

🔧 技術詳細

サーバーはリポジトリのルートディレクトリに .tasks フォルダを作成します。
タスクリストは2 - 3単語の説明に基づくファイル名を使用して保存されます。
タスクリスト内のすべてのタスクが完了すると、ファイルは ✅ 接頭辞付きの新しいファイル名にリネームされます。
サーバーはCursorのエージェント入力テキストからタスクを解析します。
複数のパターンマッチング技術を使用してタスクを抽出します：
- 番号付きの手順（1. 最初の手順）
- リスト項目（* 項目一）
- “should”、“must”、“need” のような文
明確なタスクが見つからない場合、内容は論理的な部分に整理されます。
結果を使用して、タスクの進捗状況を追跡および更新することができます。