包括的なソフトウェアライフサイクル管理のためのモデルコンテキストプロトコル(MCP)サーバー。 このサーバーは、完全なトレーサビリティと自動状態管理を備えたSQLiteデータベースによる要件、タスク、アーキテクチャの決定の構成された追跡を提供します。

##特徴

• 要求管理: 検証とライフサイクルトラッキングでソフトウェアの要件を作成および管理
• タスク管理: 階層構造と努力推定で実装タスクを追跡
• 建築決定:完全な文脈を持つレコードADR(建築決定記録)
• プロジェクトダッシュボード:リアルタイムプロジェクト健康メトリックとステータスレポート
• 要求の追跡:実施による条件からの完全なトレーサビリティ
• ステータス検証: ライフサイクル状態遷移の自動検証
• セーフティ編集と履歴:フィールドの履歴、承認された要件とリビジョンチェックの理由でレコードを編集する。誤って作成したレコードを削除
• Relationship Tracking:要件、タスク、アーキテクチャ間の多くの対人関係

クイックスタート

インストールオプション

前提条件(オプション)

Lifecycle MCP Server

A Model Context Protocol (MCP) server for comprehensive software lifecycle management. This server provides structured tracking of requirements, tasks, and architecture decisions through a SQLite database with full traceability and automated state management.

Features

• Requirements Management: Create and manage software requirements with validation and lifecycle tracking
• Task Management: Track implementation tasks with hierarchical structure and effort estimation
• Architecture Decisions: Record ADRs (Architecture Decision Records) with full context
• Project Dashboards: Real-time project health metrics and status reporting
• Requirement Tracing: Complete traceability from requirements through implementation
• State Validation: Automatic validation of lifecycle state transitions
• Safe Editing and History: Edit records in place with per-field history, reasons for approved requirements and revision checks; delete records created by mistake
• Relationship Tracking: Many-to-many relationships between requirements, tasks, and architecture

Quick Start

# 1. Clone the repository
git clone https://github.com/heffrey78/lifecycle-mcp.git
cd lifecycle-mcp

# 2. Install globally (easiest for using across projects)
uv tool install .        # or: pip install -e .

# 3. Go to any project where you want to use lifecycle management
cd /path/to/your/project

# 4. Add the MCP server to Claude
claude mcp add lifecycle lifecycle-mcp -e LIFECYCLE_DB=/path/to/your/project/lifecycle.db

# 5. Start using lifecycle tools in Claude!

Installation Options

Prerequisites (Optional)

If you want to use uv (faster Python package manager):

# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Or with homebrew
brew install uv

Clone the Repository

git clone https://github.com/heffrey78/lifecycle-mcp.git
cd lifecycle-mcp

Usage with Claude Code

For detailed examples and scenarios, see USAGE_EXAMPLES.md.

Option 1: Global Installation (Recommended for Multiple Projects)

Install the server globally so it can be used from any project:

# From the lifecycle-mcp directory (add --editable to pick up source changes)
uv tool install .        # or: pip install -e .

# Now from ANY project directory, add the server:
claude mcp add lifecycle lifecycle-mcp -e LIFECYCLE_DB=./lifecycle.db

Note: Each project gets its own database file in its directory.

Option 2: Run from Source with uv

If you prefer not to install globally:

# Get the full path to the lifecycle-mcp directory
LIFECYCLE_PATH="/path/to/lifecycle-mcp"  # Replace with your actual path

# From any project directory:
claude mcp add lifecycle $(which uv) -- --directory $LIFECYCLE_PATH run server.py -e LIFECYCLE_DB=./lifecycle.db

Option 3: Direct Python Execution

For maximum compatibility:

# Get the full path to the server