MCP タスクオーガナイザー

Cursorエージェントのプランを構造化されたマークダウンタスクリストに変換し、リポジトリに整理するMCPサーバー。このサーバーは、AIが生成したプランと推奨事項を実用的な仕様として追跡するのに役立ちます。

特徴

• カーソルエージェントプランからタスクを自動的に抽出します
• 整理されたタスク管理のためにリポジトリに.tasksフォルダを作成します
• 識別しやすいように説明的なファイル名（例：「refactor-authentication.md」）を使用する
• 完了したタスクリストに自動的に✅プレフィックスを付けます
• 適切なマークダウン構造でプランをフォーマットします
• コンテンツを概要、実装の詳細、次のステップに整理します
• Claude for Desktop およびその他の MCP クライアントと統合します

インストール

前提条件

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

クイックインストール

Unix ベースのシステム (macOS、Linux) の場合:

Windowsの場合:

手動インストール

Claude for Desktop での使用

1. claude.ai/downloadからClaude for Desktopをインストールします。
2. この MCP サーバーを使用するように Claude for Desktop を構成します。~/Library/Application Support/Claude/claude_desktop_config.json (macOS) または%APPDATA%\Claude\claude_desktop_config.json (Windows) を開き、以下を追加します。
   { "mcpServers": { "tasks-organizer": { "command": "python", "args": ["-m", "tasks_organizer"] } } }
3. デスクトップ版のClaudeを再起動
4. カーソルの計画について Claude に問い合わせて、サーバーを使用します。例:
   • 「このカーソル プランを、説明が 'auth-refactor' である 'Refactor Authentication' というタスク リストに変換します: [プランを貼り付け]」
   • 「このカーソルエージェントの出力から、タイトル「データベース移行」、説明「db-migration」でマークダウンタスクリストを作成します: [出力を貼り付け]」
   • 「認証リファクタリングタスクリストのタスク2を完了としてマークする」
   • 「リポジトリ内のすべてのタスクファイルを一覧表示する」

利用可能なツール

サーバーは次のツールを提供します:

1. タスクリストを作成する

新しいタスク リストを作成し、.tasks フォルダーに保存します。

パラメータ:

• title : タスクリストのタイトル
• description : ファイル名の短い2〜3語の説明（例："refactor-authentication"）
• repo_path : リポジトリルートへのパス（デフォルトは現在のディレクトリ）
• include_metadata : 作成日時を含めるかどうか

2. 計画をタスクに変換する

カーソル エージェントのプラン テキストをフォーマットされた Markdown タスク リストに変換して保存します。

パラメータ:

• plan_text : カーソルエージェントからのプランテキスト
• title : タスクリストのタイトル
• description : ファイル名の短い2〜3語の説明（例："refactor-authentication"）
• repo_path : リポジトリルートへのパス（デフォルトは現在のディレクトリ）
• include_metadata : 日付や時刻などのメタデータを含めるかどうか

3. タスクの追加

既存のタスク リストに新しいタスクを追加します。

パラメータ:

• description : タスクリストファイルの説明識別子
• task_text : 新しいタスクのテキスト
• repo_path : リポジトリルートへのパス（デフォルトは現在のディレクトリ）
• section : タスクを追加するセクション (デフォルトは「タスク」)

4. タスク完了をマークする

特定のタスクを完了としてマークします。

パラメータ:

• description : タスクリストファイルの説明識別子
• task_number : 完了としてマークするタスクの番号
• repo_path : リポジトリルートへのパス（デフォルトは現在のディレクトリ）
• section : タスクがどのセクションにあるか（デフォルトは「タスク」）

5. すべてのタスクの完了を確認する

すべてのタスクが完了しているかどうかを確認し、✅ プレフィックスを付けて名前を変更してタスク リストを完了としてマークします。

パラメータ:

• description : タスクリストファイルの説明識別子
• repo_path : リポジトリルートへのパス（デフォルトは現在のディレクトリ）

6. タスクファイルのリスト

.tasks ディレクトリ内のすべてのタスク ファイルを一覧表示します。

パラメータ:

• repo_path : リポジトリルートへのパス（デフォルトは現在のディレクトリ）
• include_completed : 完了したタスクリストを出力に含めるかどうか

仕組み

1. サーバーはリポジトリのルートに.tasksフォルダを作成します。
2. タスクリストは、2〜3語の説明に基づいた説明的なファイル名で保存されます。
3. リスト内のすべてのタスクが完了すると、ファイル名が✅プレフィックス付きに変更されます。
4. サーバーはカーソルのエージェントからの入力テキストを解析してタスクを抽出します。
5. さまざまなパターン マッチング手法を使用してタスクを抽出します。
   • 番号付き手順（1. 最初のステップ）
   • 箇条書き（*項目1）
   • 「すべき」「しなければならない」「必要がある」などのキーワードを含むタスクのような文
6. 明確なタスクが見つからない場合は、コンテンツを論理的なセクションに整理します。
7. タスクの進行に応じて結果を追跡および更新できます

ワークフローの例

1. エージェントが認証システムの変更を提案します
2. このプランをタスクリストに変換します: convert_plan_to_tasks(plan_text, "Auth System Refactor", "auth-refactor")
3. タスクは.tasks/auth-refactor.mdに保存されます。
4. タスクを完了したら、マークを付けます: mark_task_complete("auth-refactor", 1)
5. すべてのタスクが完了したら: check_all_tasks_complete("auth-refactor")
6. ファイル名は.tasks/✅auth-refactor.mdに変更されます。

ライセンス

マサチューセッツ工科大学