MCP Server Zplanner

🚀 zPlanner v1.4.0

zPlannerは、コマンドラインツールで、特にソフトウェア開発プロジェクトの管理に重点を置いたプロジェクトの計画と管理を支援することを目的としています。このツールは、複雑なグラフィカルユーザーインターフェイスを必要とせず、ターミナルから直接プロジェクトを管理する必要性から生まれました。

zPlannerの主な特徴は、AI支援開発IDEの記憶システムとしての機能です。構造化されたプロジェクト記録を維持することで、ZPlannerは開発のコンテキストを保存し、AIアシスタントがプロジェクトの構造、履歴、現在の状態をよりよく理解し、より正確で状況に応じた提案とサポートを提供できるようにします。

🚀 クイックスタート

目的

zPlannerの作成目的は以下の通りです。

1. シンプルさ：ターミナルから直接プロジェクトを管理する
2. 効率性：行政タスクの時間を削減する
3. 柔軟性：さまざまなプロジェクトタイプや方法論に適応する
4. 可視化：明確でレスポンシブなHTMLレポートを生成する
5. 追跡可能性：進捗履歴と更新記録を維持する
6. AIコンテキスト：AI支援開発の記憶システムとして、構造化されたプロジェクトコンテキストを維持する

AI優先設計

zPlannerは、現代のAI支援開発に合わせて最適化されています。

• コンテキストの保持：AIアシスタントが使用する構造化された履歴記憶を維持する
• 階層構造：AIがプロジェクトの組織構造を理解するのに役立つ
• 変更追跡：AIアシスタントがプロジェクトの進化を把握できるようにする
• 明確なドキュメント：統一された形式でAIの解釈能力を向上させる

✨ 主な機能

プロジェクト管理

• プロジェクトの作成と設定
• 階層構造（フェーズ、タスク、サブタスク）
• 自動進捗計算
• レスポンシブなHTMLレポートのエクスポート
• 更新日付の追跡

フェーズ管理

• フェーズの追加
• フェーズの並べ替え
• フェーズの名前変更
• フェーズの削除
• フェーズごとの進捗計算

タスク管理

• メインタスクの追加
• サブタスクの作成
• 完了のマーキング
• 説明の更新
• タスクの削除

HTMLレポート

• 現代的なレスポンシブデザイン
• 明確な階層構造の可視化
• 進捗インジケーター
• 更新履歴
• 専用のBEM CSSスタイル

📦 インストール

npm install -g zplanner

💻 使用例

基本的な使用法

プロジェクト管理

# 新しいプロジェクトを初期化する
zplanner init

# プロジェクトドキュメントを生成する
zplanner generate

# プロジェクト設定を構成する
zplanner config

フェーズ操作

# 新しいフェーズを作成する
zplanner phase create <名称>

# 既存のフェーズを更新する
zplanner phase update <名称> --start=<開始日付> --end=<終了日付>

# フェーズを削除する
zplanner phase delete <名称>

タスク管理

# 現在のフェーズにタスクを追加する
zplanner task add <タイトル> --phase=<フェーズ名>

# タスクの詳細を更新する
zplanner task update <ID> --title=<新しいタイトル> --status=<状態>

# すべてのタスクをリストする
zplanner task list --phase=<フェーズ名>

高度な使用法

# 高度なシナリオのコマンド例
# ここに高度なシナリオの説明を追加する

📚 ドキュメント

プロジェクト構造

src/
├── main.ts        # メインプログラムのエントリーポイント
├── services/      # サービスモジュール
│   ├── PhaseService.ts     # フェーズサービス
│   └── TaskService.ts      # タスクサービス
└── utils/         # ユーティリティ関数
    └── config.ts   # 設定管理

config/
├── phases.json    # フェーズ定義
└── tasks.json     # タスク記録

reports/
├── output.html     # 生成されたレポートファイル
└── templates/      # レポートテンプレート

開発環境設定

# リポジトリをクローンし、依存関係をインストールする
git clone https://github.com/cyllas/zPlanner.git
cd zPlanner
npm install

# 開発モードを起動する
npm run dev

設定ファイル

settings.tsでは、以下のような設定が可能です。

export const settings = {
  defaultLanguage: "zh-CN",    // デフォルト言語を中国語に設定
  dateFormat: "MM/DD/YYYY",     // 日付形式: MM/DD/YYYY
  timeZone: "Asia/Shanghai",   // タイムゾーンを上海に設定
  projectDefaults: {
    outputFormat: "html",       // デフォルトの出力形式をHTMLに設定
    indentSize: 2,              // インデントサイズを2つのスペースに設定
  },
  repository: {                 // リポジトリ情報
    url: "https://github.com/cyllas/zPlanner",
  },
  version: "1.4.0",            // 現在のバージョン番号
};

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細な条項はLICENSEファイルを参照してください。