github-project-manager-mcp

GitHub Project Manager MCP - Complete Edition

A comprehensive GitHub-integrated project management MCP server for Claude Desktop with 4 professional-grade tools for complete project lifecycle management.

🎯 Complete Feature Set

🚀 Advanced Project Planning (4 tools)

• generate_prd - Generate comprehensive Product Requirements Documents
• parse_prd - Parse PRDs and generate actionable development tasks
• enhance_prd - Enhance existing PRDs with AI-powered analysis
• add_feature - NEW! Add features with comprehensive impact analysis and automated planning

🔥 NEW: Feature Addition with Impact Analysis

The add_feature tool provides enterprise-grade feature planning capabilities:

📊 Comprehensive Impact Analysis

• Codebase Analysis: Automatically analyzes existing project structure, tech stack, and development velocity
• Integration Assessment: Identifies affected components, integration points, and potential conflicts
• Complexity Evaluation: AI-powered analysis of feature complexity with risk assessment
• Resource Impact: Evaluates impact on existing milestones, workload, and team capacity

🗺️ Automated Implementation Planning

• Roadmap Generation: Creates phase-based implementation roadmap with dependencies
• Task Breakdown: Generates actionable tasks with acceptance criteria and effort estimates
• Timeline Estimation: Provides realistic hour and story point estimates
• Risk Management: Identifies potential risks and provides mitigation strategies

🔧 Full GitHub Integration

• Milestone Creation: Automatically creates dedicated milestones for features
• Issue Generation: Creates GitHub issues for each implementation task
• Smart Labeling: Assigns appropriate labels based on task type and phase
• Team Recommendations: Suggests assignees based on task requirements

🚀 Installation & Setup

1. Clone and Build

git clone https://github.com/Faresabdelghany/github-project-manager-mcp.git
cd github-project-manager-mcp
npm install
npm run build

2. GitHub Token Setup

1. Go to GitHub Settings → Developer settings → Personal access tokens → Tokens (classic)
2. Generate a new token with these scopes:
   • repo (Full control of private repositories)
   • write:org (Write organization data)
   • read:org (Read organization data)
   • project (Full control of projects)

3. Claude Desktop Configuration

Add this to your Claude Desktop MCP configuration file:

Configuration File Location:

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "github-project-manager": {
      "command": "node",
      "args": ["/path/to/github-project-manager-mcp/build/index.js"],
      "env": {
        "GITHUB_TOKEN": "your-github-personal-access-token",
        "GITHUB_OWNER": "your-github-username",
        "GITHUB_REPO": "your-repository-name"
      }
    }
  }
}

Replace:

• /path/to/github-project-manager-mcp/build/index.js with actual path
• your-github-personal-access-token with your GitHub token
• your-github-username with your GitHub username
• your-repository-name with target repository

4. Restart Claude Desktop

After saving the configuration, restart Claude Desktop to load the MCP server.

💡 Usage Examples

Feature Addition with Impact Analysis

Add a new feature called "Real-time Notifications" with description "Push notification system for course updates and announcements" with business justification "Improve user engagement by 25% and reduce course dropout rates" and create milestone and issues

PRD Generation and Enhancement

Generate a PRD for "Mobile Learning App" targeting "students and educators" with key features "video lessons, interactive quizzes, progress tracking, offline mode"

Enhance this PRD content with comprehensive market analysis and competitive landscape assessment

PRD Parsing and Task Generation

Parse this PRD content for project "Course Platform" and create milestone due on 2025-09-30 with issues assigned to john-doe

🎯 add_feature Tool Capabilities

Intelligent Analysis Features

• Tech Stack Detection: Automatically identifies languages, frameworks, and architecture patterns
• Development Velocity: Analyzes commit history and team productivity metrics
• Dependency Mapping: Identifies integration dependencies and coordination requirements
• Conflict Detection: Spots potential conflicts with existing work

Implementation Planning

• Phase-Based Roadmaps: Structured implementation with clear phases and dependencies
• Effort Estimation: AI-powered complexity analysis with hour and story point estimates
• Risk Assessment: Proactive identification of technical and business risks
• Team Coordination: Recommendations for team member assignments and coordination

Automation Capabilities

• Milestone Creation: Automatically creates dedicated feature milestones
• Issue Generation: Creates properly labeled and structured GitHub issues
• Progress Tracking: Sets up tracking mechanisms for feature development
• Documentation: Generates comprehensive implementation documentation

🛠 Available Tool Categories

Core GitHub Integration

• Full GitHub API Integration with Octokit for real-time repository data
• Comprehensive Error Handling with detailed validation and user feedback
• Professional Documentation with complete setup and usage guides

Advanced Features

• AI-Powered Analysis for complexity assessment and impact evaluation
• Smart Recommendations based on project context and best practices
• Automated Planning with realistic timelines and resource allocation
• Risk Management with proactive identification and mitigation strategies

Professional Workflows

• Enterprise-Grade Planning suitable for production environments
• Team Collaboration features for multi-developer projects
• Progress Monitoring with detailed metrics and reporting
• Quality Assurance frameworks and testing recommendations

🔧 Technical Implementation

Architecture

• TypeScript for type safety and better development experience
• @modelcontextprotocol/sdk for MCP protocol implementation
• @octokit/rest for comprehensive GitHub API integration
• AI-Powered Analysis for intelligent feature assessment

GitHub API Integration

• Repository Analysis for comprehensive project understanding
• Issue Management with full CRUD operations and smart labeling
• Milestone Management with progress tracking and timeline analysis
• Team Management with workload analysis and assignment recommendations

Data Management

• Real-time Analysis of repository structure and development patterns
• Intelligent Caching for performance optimization
• Progress Tracking with detailed metrics and reporting
• Impact Assessment across all project dimensions

🎯 Professional Use Cases

Software Development Teams

• Feature Planning: Comprehensive impact analysis before implementation
• Resource Management: Intelligent workload distribution and timeline planning
• Risk Mitigation: Proactive identification and management of project risks
• Quality Assurance: Automated testing and documentation planning

Product Managers

• Strategic Planning: PRD generation and enhancement with market insights
• Feature Prioritization: Data-driven feature planning and impact assessment
• Stakeholder Communication: Professional documentation and progress reporting
• Market Analysis: Competitive landscape assessment and positioning strategies

Project Managers

• Timeline Management: Realistic project planning with dependency management
• Resource Allocation: Intelligent team assignment and workload balancing
• Progress Monitoring: Comprehensive tracking and reporting capabilities
• Risk Assessment: Proactive risk identification and mitigation planning

Development Teams

• Technical Planning: Detailed implementation roadmaps with clear deliverables
• Task Management: Automated task breakdown with acceptance criteria
• Quality Standards: Built-in testing and documentation requirements
• Collaboration: Clear assignment recommendations and dependency management

🚀 Getting Started

1. Install and configure the MCP server following the setup guide
2. Set up GitHub token with all required permissions
3. Configure repository in environment variables
4. Test basic functionality with simple feature additions
5. Explore advanced features like comprehensive impact analysis
6. Integrate into workflows for ongoing project management

🔒 Security & Permissions

Required GitHub Scopes

• repo - Full repository access for analysis and management
• project - Project management capabilities
• read:org / write:org - Organization access for team analysis

Data Security

• No external storage - all data remains in GitHub and memory
• Secure token handling via environment variables
• API rate limiting compliance for reliable operation
• Error handling without exposing sensitive information

🤝 Contributing

1. Fork the repository and create a feature branch
2. Implement changes following TypeScript best practices
3. Add comprehensive tests for new functionality
4. Update documentation for any new features
5. Submit a pull request with detailed description

📄 License

MIT License - see LICENSE file for complete details.

🆘 Support & Troubleshooting

Common Issues

1. Token Permissions: Ensure GitHub token has all required scopes
2. Repository Access: Verify GITHUB_OWNER and GITHUB_REPO are correct
3. Environment Variables: Check all environment variables are properly set
4. Network Connectivity: Verify GitHub API accessibility

Getting Help

• Review the troubleshooting section and configuration examples
• Check GitHub token permissions and repository access
• Verify Claude Desktop configuration and restart if needed
• Examine server logs for detailed error messages and diagnostics

---

⭐ Enterprise-Grade Project Management - This MCP server provides professional project management capabilities with AI-powered analysis, automated planning, and seamless GitHub integration. Perfect for teams seeking intelligent project management directly within Claude Desktop.