Task Manager MCP

🚀 タスクマネージャーガイド

このタスクマネージャーは、開発過程におけるタスクの計画と追跡を支援するためのツールです。統合されたツールとAPIエンドポイントを通じて、機能要求とそれに関連するタスクを効果的に管理および監視することができます。

🚀 クイックスタート

1. コードリポジトリのダウンロード：GitHub から最新バージョンを取得します。
2. 依存関係のインストール：npm install を実行して、必要なパッケージをすべてインストールします。
3. 環境変数の設定：.env ファイルを作成し、データベース接続やAPIキーなどの適切な値を記入します。
4. サービスの起動：node index.js を実行して、タスクマネージャーを起動します。

✨ 主な機能

計画特性 (plan_feature)

ユーザーが提供する機能説明に基づいて、初期タスクリストを生成します。

リクエスト形式

{
  "featureDescription": "JWT認証を追加する",
  "userId": "123"
}

レスポンス形式

{
  "status": "completed",
  "message": "認証フローを設計し、APIエンドポイントを定義する。",
  "taskId": "task_001",
  "featureId": "fea_001"
}

タスク完了のマーク (mark_task_complete)

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

リクエスト形式

{
  "taskId": "task_001",
  "featureId": "fea_001"
}

レスポンス形式

{
  "status": "completed",
  "message": "認証フローの設計を完了しました。",
  "nextTaskId": "task_002",
  "featureId": "fea_001"
}

次のタスクの取得 (get_next_task)

特定の機能の次の処理対象タスクを取得します。

リクエスト形式

{
  "featureId": "fea_001"
}

レスポンス形式

{
  "status": "completed",
  "message": "認証APIエンドポイントを実装する。",
  "taskId": "task_002",
  "featureId": "fea_001"
}

変更のレビュー (review_changes)

完了したタスクの成果をレビューします。

リクエスト形式

{
  "featureId": "fea_001"
}

レスポンス形式

{
  "status": "completed",
  "message": "コードレビューが完了し、マージ準備ができました。",
  "featureId": "fea_001"
}

📦 インストール

コードリポジトリのダウンロード

GitHub から最新のコードリポジトリをダウンロードできます。

依存関係のインストール

必要な依存関係をnpmを使用してインストールします。

npm install

環境変数の設定

.env ファイルを作成し、以下の内容を追加します。

PORT=3000  # サービスが動作するポート
DB_URL=mongodb://localhost:27017/taskdb  # データベース接続URL
OPENAI_API_KEY=your_openai_api_key  # OpenAI APIキー

サービスの起動

node index.js

💻 使用例

基本的な使用法

サービスの起動

MongoDBがインストールされて実行されていることを確認し、タスクマネージャーを起動します。

node index.js

フロントエンドのアクセス

ブラウザを開き、http://localhost:3000 にアクセスします。

ツールの使用

必要に応じて、提供されているツール (plan_feature, mark_task_complete など) を使用して、タスクと機能を管理します。

📚 ドキュメント

APIの基本URL

すべてのリクエストは http://localhost:3000 に送信する必要があります。

すべての機能の取得

GET /api/features

レスポンス例

[
  {
    "id": "fea_001",
    "description": "JWT認証を追加する"
  },
  {
    "id": "fea_002",
    "description": "ユーザー認証を実装する"
  }
]

特定の機能のタスクの取得

GET /api/tasks/fea_001

レスポンス例

[
  {
    "id": "task_001",
    "description": "認証フローを設計する",
    "status": "completed"
  },
  {
    "id": "task_002",
    "description": "認証APIエンドポイントを実装する",
    "status": "in-progress"
  }
]

🔧 技術詳細

OpenAIとの統合

このタスクマネージャーは、タスクの分解とコードレビューを自動生成するために、OpenAIのAPIを統合しています。

OpenAIの設定

.env ファイルに OPENAI_API_KEY を記入してください。

OPENAI_API_KEY=your_openai_api_key

OpenAIを使用したタスク分解

plan_feature ツールを使用すると、システムは自動的にOpenAIのAPIを呼び出してタスクリストを生成します。

MongoDBとの統合

データはMongoDBに保存され、デフォルトの接続文字列は mongodb://localhost:27017/taskdb です。.env ファイルの DB_URL を変更することで、他のデータベースを使用することができます。

よくある質問

• 質問：データベース接続エラーはどう処理すればいいですか？ 回答：MongoDBが実行されていることを確認し、.env ファイルの DB_URL が正しいことを確認してください。
• 質問：APIエンドポイントにアクセスできません。 回答：サービスが正常に起動していることを確認し、コンソールにエラーメッセージが表示されていないか確認してください。

更新履歴

バージョン 1.0.0

• 基本的なタスク管理機能を含む初期リリース。

バージョン 2.0.0

• 変更のレビュー機能を追加。
• APIドキュメントを改善。

📄 セキュリティガイド

データ暗号化

すべての機密情報（APIキーなど）は暗号化して保存し、コード内に平文で記載しないようにしてください。

認証

本番環境では、APIエンドポイントへのアクセスを制限するために、認証を有効にすることをお勧めします。

ログ記録

監査とトラブルシューティングを容易にするために、詳細なログ記録メカニズムを実装してください。

エラー処理

• 404 Not Found：リクエストされたリソースが存在しません。
• 500 Internal Server Error：サーバーでエラーが発生しました。

連絡先とサポート

ヘルプが必要な場合や問題を報告する場合は、support@taskmanager.com までお問い合わせください。