GitHub Issue Finder

Integrates with GitHub's API to find similar issues using Jaccard similarity, streamlining support workflows and reducing response times in project management.

Installation Instructions

README: https://github.com/Jake-Mok-Nelson/mcp-find-similar-github-issues

GitHub Support Assistant

An MCP server that helps support engineers find similar GitHub issues to speed up troubleshooting.

Setup

1. Install dependencies:

npm install

2. Set your GitHub token as an environment variable:

export GITHUB_TOKEN=your_github_personal_access_token

3. Build the server:

npm run build

Integrating with Claude:

Update the claude desktop configuration, e.g. code ~/Library/Application\ Support/Claude/claude_desktop_config.json

Update it to include the full path that this repository was cloned to:

{
    "mcpServers": {
        "find-similar-github-issues": {
            "command": "node",
            "args": [
                "/Users/<repo_path>/build/index.js"
            ]
        }
    }
}

Features

• Searches for similar issues in a GitHub repository based on issue description
• Calculates similarity scores to rank results
• Returns formatted issue details with links

Usage

The server provides one tool:

find-similar-issues

Finds GitHub issues similar to a given description.

Parameters:

• owner: GitHub repository owner/organization
• repo: GitHub repository name
• issueDescription: Description of the issue to find similar ones for
• maxResults: Maximum number of similar issues to return (default: 5)

Implementation Notes

This implementation uses a simple Jaccard similarity coefficient to compare text. For production use, consider implementing more sophisticated NLP techniques for better similarity matching.