GitHub Triage MCP

The GitHub Triage MCP assist with the management and automation of triage workflows within GitHub repositories. It enables users to streamline issue labeling.

Features

Issue Triage:

• Retrieve detailed information about GitHub issues (e.g., title, state, labels, comments).
• Identify untriaged issues, such as issues without a milestone or label.
• Fetch lists of open issues and format them for quick reference or reporting.

Label Management:

• Fetch all labels associated with a repository as a formatted string or table.
• Add labels to issues or pull requests based on specific criteria and instructions.

Prerequisites

To use this server, ensure the following tools are installed on your development machine:

• .NET SDK (e.g., .NET 9)

Setup

1. Clone this repository
2. Navigate to the project directory
3. Build the project: dotnet build
4. Configure with VS Code or other client:

"mcp-github-triage": {
    "type": "stdio",
    "command": "dotnet",
    "args": [
        "run",
        "--project",
        "/Users/jsuarezruiz/GitHub/mobile-dev-mcp-server/src/GitHubTriageMcpServer.csproj"
    ],
    "env": { 
    "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>",
    }
}

Testing

The MCP Inspector is an interactive developer tool designed for testing and debugging MCP servers. Can start the inspector from our application folder using the nodejs command npx with the following command:

npx @modelcontextprotocol/inspector dotnet run

Tools

• triage_get_issues_count: Fetches the count of open issues in the specified GitHub repository.
• triage_get_issues: Fetches and formats a list of open issues in the specified GitHub repository.
• triage_get_labels_count: Fetches the total number of labels in the specified GitHub repository.
• triage_get_labels: Fetches and formats a list of labels in the specified GitHub repository.
• triage_summary_issue: Fetches a summary of a GitHub issue, including metadata, labels, and comments (LLM).
• triage_add_labels_issue: Applies specified labels to a GitHub issue, using the issue details and some specific instructions.

Gallery

<img src="https://raw.githubusercontent.com/jsuarezruiz/github-triage-mcp-server/refs/heads/main/images/triage-tools.png" width="30%"></img> <img src="https://raw.githubusercontent.com/jsuarezruiz/github-triage-mcp-server/refs/heads/main/images/triage-issue-list.png" width="30%"></img>

Contributing

I gladly welcome contributions to help improve this project! Whether you're fixing bugs, adding new features, or enhancing documentation, your support is greatly appreciated.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/my-feature)
3. Make your changes
4. Commit your changes (git commit -m 'Add a new feature')
5. Push to the branch (git push origin feature/my-feature)
6. Open a Pull Request

License

This project is available under the MIT License.