mcp-github-project-manager
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Integrations
GitHub Project Manager MCP Server
A Model Context Protocol (MCP) server implementation that provides GitHub Projects functionality through standardized tools and resources. This server enables LLM clients to manage GitHub Projects programmatically through the MCP interface.
Overview
This server implements the Model Context Protocol to expose GitHub Projects functionality to LLM clients. It provides tools for managing projects, milestones, sprints, and metrics through GitHub's GraphQL API while maintaining state and handling errors according to MCP specifications.
Key Features
- Project Management
- Create and manage GitHub Projects (v2)
- Handle project settings and configurations
- Manage project visibility and access
- Project Resources
- Issues and milestones management
- Sprint planning and tracking
- Custom fields and views
- Resource versioning and locking
- MCP Implementation
- Full MCP specification compliance
- Standardized tool definitions
- Resource state management
- Progressive response handling
- Comprehensive error handling
- GitHub Integration
- GraphQL API integration
- Rate limit handling
- Optimistic concurrency
- Webhook support (planned)
Installation
Configuration
Required environment variables:
The GitHub token requires these permissions:
repo(Full repository access)project(Project access)write:org(Organization access)
Usage
See the User Guide for detailed usage instructions.
Architecture
The server follows Clean Architecture principles with distinct layers:
- Domain Layer: Core entities and repository interfaces
- Infrastructure Layer: GitHub API integration and implementations
- Service Layer: Business logic coordination
- MCP Layer: Tool definitions and request handling
See ARCHITECTURE.md for detailed architecture documentation.
Current Status
Core Features
| Feature | Status | Notes |
|---|---|---|
| Project Creation | ✅ Complete | Full support for v2 projects |
| Milestone Management | ✅ Complete | CRUD operations implemented |
| Sprint Planning | ✅ Complete | Including metrics tracking |
| Issue Management | ✅ Complete | With custom fields support |
| Resource Versioning | 🏗️ In Progress | Basic versioning implemented |
| Webhook Integration | 📅 Planned | Real-time updates |
MCP Implementation
| Component | Status | Notes |
|---|---|---|
| Tool Definitions | ✅ Complete | All core tools implemented |
| Resource Management | ✅ Complete | With optimistic locking |
| Response Handling | 🏗️ In Progress | Progressive responses WIP |
| Error Handling | 🏗️ In Progress | Comprehensive error mapping |
| State Management | ✅ Complete | With conflict resolution |
See docs/mcp/gaps-analysis.md for detailed implementation status.
Documentation
- User Guide - Detailed usage instructions
- Architecture - System architecture and design
- Contributing - Development guidelines
- MCP Documentation - MCP-specific details
Development
Testing
Code Quality
Contributing
See CONTRIBUTING.md for development guidelines.
License
This server cannot be installed
Provides comprehensive tools for managing GitHub projects, milestones, tasks, and sprints. This server integrates deeply with GitHub Projects V2, offering features like automated kanban workflows, sprint planning, and custom field management.