Skip to content

Add GitHub Projects and Issues Management Tools to MCP Server #2

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
wants to merge 3 commits into
base: main
Choose a base branch
from

Conversation

Copilot
Copy link

@Copilot Copilot AI commented Jun 24, 2025

This PR implements comprehensive GitHub Projects and Issues Management tools for the MCP server, enabling intelligent and automated project planning, backlog grooming, and issue lifecycle management through context-aware automation.

🚀 Key Features Added

GitHub Projects v2 Integration (GraphQL)

  • list_projects_v2: List Projects v2 for organizations or users with full metadata
  • get_project_v2: Get detailed project information including custom fields
  • get_issue_node_id: Convert issue numbers to node IDs required for Projects v2 operations
  • add_issue_to_project_v2: Add issues to Projects v2 for automated workflow management

Enhanced Issue Management

  • list_milestones: List repository milestones with state filtering (open/closed/all)
  • create_milestone: Create milestones with optional descriptions and due dates
  • Enhanced existing issue toolset with milestone management capabilities

🔧 Technical Implementation

New Toolset

  • Added projects toolset with proper read/write tool categorization
  • Enhanced issues toolset with milestone management tools
  • Follows existing codebase patterns for GraphQL integration

Core Changes

  • pkg/github/projects.go: New file implementing Projects v2 tools using GraphQL API
  • pkg/github/issues.go: Added milestone management functions
  • pkg/github/server.go: Added RequiredInt64 helper for parameter validation
  • pkg/github/tools.go: Integrated new toolsets into the main toolset group

Quality Assurance

  • Comprehensive test coverage with toolsnaps validation
  • All existing tests continue to pass
  • Updated README documentation with tool descriptions and parameters

💡 Usage Examples

# List organization's Projects v2
list_projects_v2(owner="myorg", owner_type="organization")

# Get issue node ID for Projects v2 operations  
get_issue_node_id(owner="myorg", repo="myrepo", issue_number=123)

# Add issue to Projects v2
add_issue_to_project_v2(project_id="PVT_kwDOABCD...", issue_id="I_kwDOABCD...")

# Create milestone with due date
create_milestone(owner="myorg", repo="myrepo", title="v2.0", due_on="2024-12-31T23:59:59Z")

🎯 Benefits

  • Context-aware project management: Natural language integration with GitHub Projects v2
  • Automated issue triage: Easy assignment of issues to projects and milestones
  • Sprint/milestone coordination: Streamlined milestone creation and management
  • Multi-repo project support: Organization and user-level project management
  • GraphQL-powered: Leverages modern GitHub Projects v2 API for advanced automation

This implementation enables the core functionality requested in the issue: natural language and model-driven project/issue interactions, programmatic control over GitHub Projects, and automated issue lifecycle management.

Fixes #1.


💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

Copilot AI and others added 2 commits June 24, 2025 11:41
Co-authored-by: siddjoshi <5179418+siddjoshi@users.noreply.github.com>
Co-authored-by: siddjoshi <5179418+siddjoshi@users.noreply.github.com>
@Copilot Copilot AI changed the title [WIP] Add Model Context Protocol Tools to MSP Server for GitHub Projects and Issues Management Add GitHub Projects and Issues Management Tools to MCP Server Jun 24, 2025
@Copilot Copilot AI requested a review from siddjoshi June 24, 2025 11:43
Copilot finished work on behalf of siddjoshi June 24, 2025 11:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Add Model Context Protocol Tools to MCP Server for GitHub Projects and Issues Management
2 participants
pFad - Phonifier reborn

Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.

Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.


Alternative Proxies:

Alternative Proxy

pFad Proxy

pFad v3 Proxy

pFad v4 Proxy