# Task Master

> 🎯 **Simplified Trello-style task management for MCP** - Pure MCP functionality with 11 essential tools for efficient CRUD task management, eliminating complex LLM-dependent features.

<div align="center">

[![Version](https://img.shields.io/badge/version-2.0.0-blue.svg)](https://github.com/yourusername/mcp-task-master)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![TypeScript](https://img.shields.io/badge/TypeScript-007ACC?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)

**[Quick Start](#-quick-start)** • **[Documentation](#-documentation)** • **[MCP Tools](#-mcp-tools)**

</div>

## 🚀 Quick Start

### Prerequisites
- Node.js 18+
- An MCP client (Claude Desktop, VSCode with MCP extension, etc.)

### Installation

1. **Clone and build**
   ```bash
   git clone https://github.com/yourusername/mcp-task-master
   cd mcp-task-master
   npm install && npm run build
   ```

2. **Configure MCP client**

   Add to your MCP client configuration (e.g., `~/.claude/config.json`):
   ```json
   {
     "mcpServers": {
       "task-master": {
         "command": "node",
         "args": ["/path/to/mcp-task-master/dist/index.js"],
         "env": {
           "DATA_DIR": "/path/to/your/task/data"
         }
       }
     }
   }
   ```

3. **Start using**
   ```bash
   # List all tasks
   list_tasks --status all

   # Create a task (via Dashboard)
   start_dashboard
   ```

## ✨ Key Features

- **🎯 Simplified**: Reduced from 19 to 11 essential MCP tools (42% reduction)
- **⚡ Pure MCP**: No complex LLM dependencies, focusing on true MCP efficiency
- **🌐 Bilingual**: Korean/English support
- **📊 Dashboard**: Real-time React-based web interface
- **🔄 Trello-style**: Intuitive CRUD task management

## 🛠 MCP Tools (11 Essential Tools)

### 💼 Core Task Management (7 tools)
- **`list_tasks`** - List all tasks by status with Trello-style emojis
- **`execute_task`** - Simplified task execution guide
- **`get_task_detail`** - View complete task information
- **`query_task`** - Search tasks by keywords or ID
- **`update_task`** - Modify task content and properties
- **`delete_task`** - Remove specific tasks
- **`clear_all_tasks`** - Clear all tasks with backup

### 📊 Dashboard Management (4 tools)
- **`start_dashboard`** - Launch React web interface
- **`stop_dashboard`** - Stop dashboard server
- **`status_dashboard`** - Check server status
- **`list_dashboard_projects`** - View registered projects
- **`add_dashboard_project`** - Register new projects
- **`create_tasks_in_project`** - Create project-specific tasks

## 📚 Documentation

### Task Data Model (Simplified)
```typescript
interface Task {
  id: string;                    // UUID
  name: string;                  // Task name
  description: string;           // Task description
  notes?: string;               // Additional notes
  status: TaskStatus;           // pending | in_progress | completed | blocked
  dependencies: TaskDependency[]; // Task dependencies
  createdAt: Date;              // Creation date
  updatedAt: Date;              // Last modified
  completedAt?: Date;           // Completion date
  summary?: string;             // Completion summary
  relatedFiles?: RelatedFile[]; // Related files
  agent?: string;              // Assigned agent
}
```

### Environment Variables
```bash
# Required
DATA_DIR="/path/to/task/data"

# Optional
LANG="ko"                    # Language (ko/en)
ENABLE_GUI="false"          # Enable web dashboard
WEB_PORT="3000"            # Dashboard port
```

## 🎮 Usage Examples

### Basic Task Management
```bash
# List all tasks
list_tasks --status all

# Search tasks
query_task --query "fix bug" --page 1

# Get task details
get_task_detail --taskId "your-task-id"

# Update task
update_task --taskId "your-task-id" --name "New Task Name"
```

### Dashboard Operations
```bash
# Start web dashboard
start_dashboard --port 9998

# Check dashboard status
status_dashboard

# Create project tasks
create_tasks_in_project --projectName "MyProject" --tasks '[{"title":"Task 1", "priority":"High"}]'
```

## 🏗 Architecture

```
src/
├── index.ts                 # MCP server entry point (11 tools)
├── models/taskModel.ts      # Simplified data models & CRUD
├── messages/                # Bilingual message system
│   ├── korean.ts           # Korean messages
│   └── english.ts          # English messages
├── tools/
│   ├── task/              # 7 core task tools
│   └── dashboard/         # 4 dashboard tools
├── types/index.ts          # Simplified type definitions
└── utils/                  # Common utilities
```

## 🚀 Performance Improvements

| Metric | Before | After | Improvement |
|--------|---------|-------|-------------|
| **MCP Tools** | 19 | 11 | 42% reduction |
| **Code Size** | Complex | ~49KB removed | Significant |
| **Template Files** | 140+ | Direct messages | Streamlined |
| **Language Support** | 3 languages | 2 languages | Focused |
| **Memory Usage** | High | Reduced | LLM system removed |

## ⚡ What Was Removed

### Complex LLM-dependent features:
- ❌ `plan_task` - Complex task planning
- ❌ `analyze_task` - Codebase analysis
- ❌ `split_tasks` - Task decomposition (large files)
- ❌ `verify_task` - Complex quality verification
- ❌ `reflect_task` - Task retrospection
- ❌ `process_thought` - Thought processing
- ❌ `research_mode` - Research mode
- ❌ `init_project_rules` - Project rules initialization

### Simplified data model:
- ❌ `implementationGuide` - Complex implementation guides
- ❌ `verificationCriteria` - Quality verification criteria
- ❌ `analysisResult` - LLM-based analysis results
- ❌ Complex template system (140+ files)

## 🤝 Contributing

1. Fork the repository
2. Create your feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add some amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request

## 📄 License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## 🙏 Acknowledgments

- Built for the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/)
- Inspired by Trello's simplicity and effectiveness
- Focused on pure MCP efficiency without LLM complexity

---

<div align="center">

**Task Master** - *Simplified. Efficient. Pure MCP.*

[⭐ Star this repo](https://github.com/yourusername/mcp-task-master) if you find it useful!

</div>