MCP Task Manager Server

🚀 MCP タスクマネージャーサーバー

MCP タスクマネージャーサーバーは、Node.js をベースにしたツールで、タスクデータの管理と操作を行います。MCP プロトコルで定義された一連のツールを実装することで、タスクの作成、更新、削除などの操作を提供します。

🚀 クイックスタート

MCP タスクマネージャーサーバーを使用するには、まず必要な依存関係をインストールし、サーバーを起動する必要があります。以下の手順に従って操作してください。

前提条件

• Node.js (LTS バージョンを推奨)
• npm

依存関係のインストール

npm install

開発モードでの実行

npm run dev

開発モードでは、サーバーは nodemon を通じてコードの変更を自動的に読み込み、標準出力にログを出力します。デフォルトでは、ログファイルは ./data/taskmanager.db に書き込まれます。

本番環境でのビルド

npm run build

本番環境での実行

npm start

✨ 主な機能

1. サポートされるタスク操作：

   • 新しいタスクの作成
   • 既存のタスクの更新
   • タスクとその子タスクおよび依存関係の削除
   • タスクリストの読み取り
   • タスクデータのエクスポート/インポート

2. データベース管理：

   • SQLite データベースを使用してタスクデータを保存し、デフォルトのパスは ./data/taskmanager.db です。
   • 環境変数 (DATABASE_PATH) を使用してデータベースのパスを構成することができます。

3. ログ記録：

   • 異なるレベルのログ出力（デバッグ、情報、警告、エラー）を提供します。
   • デフォルトのログレベルは info で、環境変数 LOG_LEVEL で変更することができます。

4. ツールの実装：

   • 各タスク操作には、対応するツールクラスとパラメータ検証（Zod ライブラリを使用）があります。

📦 インストール

前提条件

• Node.js (LTS バージョンを推奨)
• npm

依存関係のインストール

npm install

開発モードでの実行

npm run dev

本番環境でのビルド

npm run build

本番環境での実行

npm start

📚 ドキュメント

設定

1. データベースパス：

   • DATABASE_PATH 環境変数を設定することで、デフォルトの SQLite データベースのパスを変更できます。例えば：

     DATABASE_PATH=./mydb.db npm run dev
     

2. ログレベル：

   • LOG_LEVEL 環境変数を使用してログ出力レベルを設定できます。選択可能な値は debug, info, warn, error です。例えば：

     LOG_LEVEL=debug npm run dev
     

プロジェクト構造

MCP-TaskManager/
├── src/
│   ├── config/                  # 設定管理モジュール
│   ├── db/                      # データベース関連のコード（schema.sql を含む）
│   ├── repositories/            # データアクセス層（SQLite 操作）
│   ├── services/                # コアビジネスロジックの実装
│   ├── tools/                   # MCP ツールの定義（Params.ts と Tool.ts）
│   ├── types/                  # 共有の TypeScript インターフェース
│   └── utils/                 # ログ、エラー処理などのユーティリティ関数
├── dist/                       # コンパイル後の JavaScript 出力ディレクトリ
├── docs/                      # ドキュメントと仕様書（PRD, RFC など）
├── data/                     # デフォルトの SQLite データベース保存パス（自動作成）
└── tasks.md                   # 開発タスクの追跡ファイル

コードスタイルと品質管理

1. コードフォーマット：

   • prettier を使用してコードをフォーマットし、一貫性と可読性を確保します。
   • 設定ファイル：.eslintrc.json, .prettierrc.json

2. 静的コードチェック：

   • ESLint と TypeScript を使用してコード品質をチェックします。
   • 開発中は、Husky と lint-staged を使用して自動チェックを実行します。

3. 単体テスト：

   • 完全な単体テストケースが用意されています（src/test/ ディレクトリにあります）。
   • 以下のコマンドでテストを実行できます：

     npm test
     

プロジェクト目標

1. 複雑なタスク依存関係と子タスク構造をサポートする信頼性の高いタスク管理ツールを提供する。
2. MCP プロトコルで定義されたインターフェースを実装し、他のシステムとの互換性を確保する。
3. コードの保守性と拡張性を保ち、将来的な機能拡張を容易にする。

使用シーン

• 個人用タスク管理：ユーザーはコマンドラインまたはグラフィカルインターフェースを通じてタスクを作成、更新、削除できます。
• チーム協働ツール：多ユーザーが同時に操作できます（認証モジュールと組み合わせる必要があります）。
• 自動化プロセス：API 呼び出しを通じて他のシステムに統合し、タスクの自動化を実現できます。

次のステップ

1. 依存関係をインストールし、サーバーを起動します：

   npm install && npm run dev
   

2. デフォルトのログ出力またはデータベースファイルを確認します。
3. 必要に応じて設定環境変数を変更します。

詳細な情報については、プロジェクトのドキュメントとコード実装を参照してください。