TaskMateAI

TaskMateAIは、AIが自律的にタスクを管理・実行するためのシンプルなタスク管理アプリケーションで、MCP (Model Context Protocol)を通じて操作できます。

- MCPを通じたタスクの作成・管理
- サブタスクのサポート
- 優先順位に基づくタスク処理
- タスクの進捗管理と報告機能
- ノート追加機能
- JSONファイルによるデータ永続化
- エージェントIDによる複数AIのタスク管理
- プロジェクト単位でのタスク整理

- Python 3.12以上
- uv (Python パッケージマネージャー)
- WSL (Windows Subsystem for Linux) ※Windows環境の場合

git clone https://github.com/YourUsername/TaskMateAI.git cd TaskMateAI

cd /path/to/TaskMateAI/src/TaskMateAI uv run TaskMateAI

{ "mcpServers": { "TodoApplication": { "command": "uv", "args": [ "--directory", "/絶対パス/TaskMateAI", "run", "TaskMateAI" ], "env": {}, "alwaysAllow": [ "get_tasks", "get_next_task", "create_task", "update_progress", "complete_task", "add_subtask", "update_subtask", "add_note", "list_agents", "list_projects" ], "defaultArguments": { "agent_id": "agent_123", "project_name": "" } } } }

{ "mcpServers": { "TodoApplication": { "command": "wsl.exe", "args": [ "-e", "bash", "-c", "cd /絶対パス/TaskMateAI && /home/ユーザー/.local/bin/uv run TaskMateAI" ], "env": {}, "alwaysAllow": [ "get_tasks", "get_next_task", "create_task", "update_progress", "complete_task", "add_subtask", "update_subtask", "add_note", "list_agents", "list_projects" ], "defaultArguments": { "agent_id": "agent_123", "project_name": "" } } } }

- get_tasks- タスクリストの取得（ステータスや優先度でフィルタリング可能）
- get_next_task- 優先度の高い次のタスクを取得（自動的に進行中ステータスに更新）
- create_task- 新しいタスクの作成（サブタスク付き）
- update_progress- タスクの進捗更新
- complete_task- タスクを完了としてマーク
- add_subtask- 既存タスクにサブタスクを追加
- update_subtask- サブタスクのステータス更新
- add_note- タスクにノートを追加
- list_agents- 利用可能なエージェントIDの一覧を取得
- list_projects- 特定のエージェントに関連するプロジェクトの一覧を取得

{ "id": 1, "title": "タスクのタイトル", "description": "タスクの詳細な説明", "priority": 3, "status": "todo", // "todo", "in_progress", "done" のいずれか "progress": 0, // 0-100 の進捗率 "subtasks": [ { "id": 1, "description": "サブタスクの説明", "status": "todo" // "todo", "in_progress", "done" のいずれか } ], "notes": [ { "id": 1, "content": "ノートの内容", "timestamp": "2025-02-28T09:22:53.532808" } ] }

output/ ├── tasks.json # デフォルトのタスクファイル ├── agent1/ │ ├── tasks.json # agent1のタスクファイル │ ├── project1/ │ │ └── tasks.json # agent1のproject1のタスクファイル │ └── project2/ │ └── tasks.json # agent1のproject2のタスクファイル └── agent2/ ├── tasks.json # agent2のタスクファイル └── projectA/ └── tasks.json # agent2のprojectAのタスクファイル

-

MCP設定でデフォルトエージェントを指定：defaultArgumentsでagent_idを指定することで、すべてのリクエストで自動的に使用されます。

AI会話でプロジェクトを指定：会話の中で「プロジェクトXに新しいタスクを追加して」などと指定できます。

AIからの直接指定：リクエストパラメータにagent_idとproject_nameを含めることができます。

TaskMateAI/ ├── src/ │ └── TaskMateAI/ │ ├── __init__.py # パッケージ初期化 │ └── __main__.py # メインアプリケーションコード ├── output/ # データ保存ディレクトリ │ └── tasks.json # タスクデータ (自動生成) ├── tests/ # テストコード │ ├── unit/ # ユニットテスト │ └── integration/ # 統合テスト ├── requirements.txt # 依存パッケージリスト └── README.md # このファイル

TaskMateAIでは、機能の信頼性を確保するため、包括的なテストスイートを提供しています。

tests/ ├── __init__.py # テストパッケージの初期化 ├── conftest.py # テスト用フィクスチャの定義 ├── unit/ # ユニットテスト │ ├── __init__.py │ ├── test_task_utils.py # タスク関連ユーティリティのテスト │ ├── test_mcp_tools.py # MCPツール機能のテスト │ └── test_agent_projects.py # エージェントとプロジェクト管理のテスト └── integration/ # 統合テスト └── __init__.py

-

ユニットテスト: アプリケーションの個々のコンポーネントが正しく機能することを確認します

- test_task_utils.py: タスクの読み書き、ID生成などの基本機能をテスト
- test_mcp_tools.py: MCPツールの機能（タスクの作成、更新、完了など）をテスト
- test_agent_projects.py: エージェントIDとプロジェクト管理機能をテスト

統合テスト: 複数のコンポーネントが連携して正しく動作することを確認します（将来拡張予定）

cd /path/to/TaskMateAI uv run python -m pytest -xvs

uv run python -m pytest -xvs tests/unit/test_task_utils.py

uv run python -m pytest -xvs tests/unit/test_mcp_tools.py::TestMCPTools

uv run python -m pytest -xvs tests/unit/test_task_utils.py::TestTaskUtils::test_read_tasks_with_data

- -x: エラーが発生した時点でテストを停止します
- -v: 詳細な出力を表示します
- -s: テスト中の標準出力を表示します

- タスクテンプレート機能の実装
- タスク間の依存関係管理システムの構築
- スケジュール機能の追加
- タグによるタスク分類システムの導入
- マイルストーン管理機能の実装

Interact with task, doc, and project data in Dart, an AI-native project management tool

Connect to the Taskade platform via MCP. Access tasks, projects, workflows, and AI agents in real-time through a unified workspace and API.

A Python monorepo for AI-powered project management and productivity servers, utilizing the Claude API.

Trello for Claude Code: AI-powered task management with 60 MCP tools, visual Kanban board, and intelligent orchestration for product teams and developers

An intelligent task management system based on MCP, providing an efficient programming workflow framework for AI Agents with an optional web-based GUI.

A project management and session memory tool for AI agents to track projects, tasks, and context during chat sessions.

Minimal project management for teams and AI agents.

Manages AI session handoffs and tracks next steps for projects.

AI project manager for Claude. Plain markdown, local-first workspace. 11 tools for projects, tasks, sessions, and notes. Install with: npx recap-mcp init

AI-powered tools for efficient task, requirement, and project management using the YesDev platform.