MCP タスクオーガナイザー

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

特徴

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

Related MCP server: Task Manager MCP Server

インストール

前提条件

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

クイックインストール

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

# Clone the repository git clone https://github.com/yourusername/mcp-tasks-organizer.git cd mcp-tasks-organizer # Run the installation script ./install.sh

Windowsの場合:

# Clone the repository git clone https://github.com/yourusername/mcp-tasks-organizer.git cd mcp-tasks-organizer # Run the installation script install.bat

手動インストール

# Clone the repository git clone https://github.com/yourusername/mcp-tasks-organizer.git cd mcp-tasks-organizer # Create and activate a virtual environment (optional but recommended) python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate # Install dependencies pip install -r requirements.txt # Install the package pip install -e .

Claude for Desktop での使用

claude.ai/downloadからClaude for Desktopをインストールします。
この 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"] } } }
デスクトップ版のClaudeを再起動
カーソルの計画について 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 : 完了したタスクリストを出力に含めるかどうか

仕組み

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

ワークフローの例

エージェントが認証システムの変更を提案します
このプランをタスクリストに変換します: 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に変更されます。