Github Project Manager

🚀 GitHub Project Management MCP Server

A server implementing the Model Context Protocol (MCP) to provide GitHub project functionality through standardized tools and resources. This server allows LLM clients to programmatically manage GitHub projects via the MCP interface.

🚀 Quick Start

The server implements the Model Context Protocol to expose GitHub project functionality to LLM clients. It offers tools for managing and processing projects, milestones, sprints, and metrics, maintains state through GitHub's GraphQL API, and handles errors according to the MCP specification.

✨ Features

Project Management

• Create and manage GitHub Projects (v2).
• Handle project settings and configurations.
• Manage project visibility and access permissions.

Project Resources

• Manage issues and milestones.
• Plan and track sprints.
• Customize fields and views.
• Control resource versions and perform locking.

MCP Implementation

• Fully compliant with the MCP specification.
• Standardize tool definitions with Zod validation.
• Manage resource states.
• Handle progressive responses.
• Provide comprehensive error handling.

GitHub Integration

• Integrate with the GraphQL API with Zod validation.
• Perform batch queries for related resources.
• Offer background refresh functionality.

📦 Installation

Install Dependencies

npm install mcp-server express graphql axios dotenv

Environment Variables

Create a .env file in the project root directory:

PORT=3000
DATABASE_URL=jdbc:mysql://localhost:3306/gpm_mcp?user=root&password=example
GRAPHQL_ENDPOINT=https://api.github.com/graphql

💻 Usage Examples

Start the Server

node index.js

API Call Example

Send a POST request to http://localhost:3000/api using curl or Postman:

{
  "tool": {
    "id": "github-projects",
    "name": "GitHub Projects Manager"
  },
  "command": "listProjects",
  "args": {
    "username": "your_github_username",
    "token": "your_github_token"
  }
}

🔧 Technical Details

Layered Architecture

1. Presentation Layer: Handles user requests and responses.
2. Business Logic Layer: Implements core functions such as project management and data processing.
3. Data Access Layer: Interacts with databases and external APIs (e.g., GitHub).

Key Components

• MCPServer: Handles HTTP requests and parses tool instructions.
• ProjectManager: Responsible for all operations related to GitHub projects.
• DatabaseAdapter: Provides database connection and query functions.
• GraphQLClient: Wraps calls to the GitHub GraphQL API.

Current System Status

Implemented Features

• Tool definition and execution based on the MCP protocol.
• Multi - tenant support, isolating data by user identifiers.
• Detailed audit logging, enabled by default.

To - Do List

1. Implement metrics and data analysis functions.
2. Add a visual report generator.
3. Optimize performance by introducing query batching.

📚 Documentation

• User Guide - Detailed usage instructions.
• API Reference - Comprehensive tool documentation.
• Tutorials - Step - by - step guidance.
• Examples - Code examples for common tasks.
• Architecture - System architecture and design.
• Contribution Guide - Development specifications.

Interactive Documentation

Open the API Explorer in your browser for interactive API exploration.

Development

Testing

# Unit tests
npm test

# Integration tests
npm run test:integration

# End - to - end tests
npm run test:e2e

Code Quality

# Format code
npm run format

# Type checking
npm run type-check

# Coding style check
npm run lint

Contribution

We welcome contributions to the GitHub Project Management MCP Server! Please refer to our Contribution Guide for detailed information, including:

• Development Workflow
• Coding Standards
• Testing Guidelines
• Documentation Writing Guidelines

📄 License

MIT