mcp-sprint-work-logs/README.md

MCP server for analyzing Jira sprint issues with worklog interpretation errors and Story Points achievement rate and worlogs manipulation

# MCP Sprint Work Logs

MCP server for analyzing Jira sprint issues with worklog interpretation errors and Story Points achievement rate.

## Features

- 📊 **Sprint Analysis**: Analyze sprint issues for worklog errors and Story Points achievement
- 📝 **Worklog Management**: Create, modify, and manage worklogs with LG Electronics format
- 🔍 **Issue Management**: Get current sprint issues and manage sprint lifecycle
- 📋 **Story Points Tracking**: Track Story Points completion rate and time analysis
- 🎯 **Sprint Operations**: Copy issues, create new sprint issues, and close completed sprints

## Installation

### Prerequisites

- Node.js 14.0.0 or higher
- Python 3.9+
- pip (Python package installer)

### Install via npx (Recommended)

```bash
npx mcp-sprint-work-logs
```

### Manual Installation

1. Install the package:
```bash
npm install -g mcp-sprint-work-logs
```

2. Install Python dependencies:
```bash
pip install -r requirements.txt
```

3. Configure environment variables in your MCP client:
```json
"mcp-sprint-work-logs": {
    "type": "stdio",
    "command": "npx",
    "args": ["-y", "mcp-sprint-work-logs"],
    "env": {
        "JIRA_URL": "https://your-jira-instance.com/",
        "JIRA_USERNAME": "your-username",
        "JIRA_PASSWORD": "your-password-or-token"
    }
}
```

## Usage

### Available Tools

1. **get_current_sprint_issues**: Get current sprint issues with filtering
2. **analyze_sprint**: Comprehensive sprint analysis with worklog errors and Story Points
3. **get_story_points**: Get Story Points information for an issue
4. **create_work_entry**: Create worklog with LG Electronics format
5. **get_work_logs**: Get all worklogs for an issue
6. **modify_work_entry**: Update existing worklog
7. **remove_work_entry**: Delete worklog
8. **copy_sprint_issue**: Copy existing issue to next sprint
9. **create_new_sprint_issue**: Create new sprint issue
10. **close_sprint_issue**: Close completed sprint issue

### Sprint Analysis Features

- **Worklog Error Detection**: Identifies worklogs that don't follow LG Electronics Work Description format
- **Story Points Achievement**: Calculates completion rate based on planned vs actual hours (1SP = 4 hours)
- **Sprint Period Analysis**: Provides sprint timeline and duration information
- **Comprehensive Reporting**: Detailed analysis with actionable insights

## Examples

### Analyze Sprint
```javascript
await analyze_sprint("TVPLAT-677921");
```

### Get Current Sprint Issues
```javascript
await get_current_sprint_issues();
```

### Copy Issue to Next Sprint
```javascript
await copy_sprint_issue("TVPLAT-700666", "jaehyung1.lee");
```

### Create New Sprint Issue
```javascript
await create_new_sprint_issue("jaehyung1.lee", "기타업무", "운영, 회의, 교육");
```

## Development

1. Clone the repository
2. Install dependencies: `npm install`
3. Install Python dependencies: `pip install -r requirements.txt`
4. Run: `npm start`

## License

MIT