GitHub Project Manager

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

Project Resources

MCP Implementation

GitHub Integration

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, repository interfaces, and Zod schemas

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

[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]

MCP Implementation

[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]
[object Object]	[object Object]	[object Object]

Recent Improvements

Enhanced Resource System:

Improved GitHub API Integration:

Advanced Tool System:

Rich Response Formatting:

Identified Functional Gaps

Despite the recent improvements, the following functional gaps still exist and are prioritized for future development:

Persistent Caching Strategy:

Real-time Event Processing:

Advanced GitHub Projects v2 Features:

Performance Optimization:

Data Visualization and Reporting:

See docs/mcp/gaps-analysis.md for detailed implementation status.

Documentation

User Guide - Detailed usage instructions

API Reference - Comprehensive tool documentation

Tutorials - Step-by-step guides

Examples - Code examples for common tasks

Architecture - System architecture and design

Contributing - Development guidelines

MCP Documentation - MCP-specific details

Interactive Documentation

For an interactive exploration of the API, open the API Explorer in your browser.

Development

Testing

Code Quality

Contributing

We welcome contributions to the GitHub Project Manager MCP Server! Please see our Contributing Guide for details on:

Development Workflow

Code Standards

Testing Guidelines

Documentation Guidelines

License

MIT