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)

npx mcp-sprint-work-logs

Manual Installation

1. Install the package:

npm install -g mcp-sprint-work-logs

2. Install Python dependencies:

pip install -r requirements.txt

3. Configure environment variables in your MCP client:

"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

await analyze_sprint("TVPLAT-677921");

Get Current Sprint Issues

await get_current_sprint_issues();

Copy Issue to Next Sprint

await copy_sprint_issue("TVPLAT-700666", "jaehyung1.lee");

Create New Sprint Issue

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