mcp-find-similar-github-issues

mcp-find-similar-github-issues

2
developer_toolscommunication

GitHub Support Assistant is a Model Context Protocol (MCP) server designed to help support engineers quickly find similar issues in GitHub repositories. It uses Jaccard similarity coefficients for text comparison and returns results with formatted issue details and links.

GitHub Support Assistant

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

Setup

  1. Install dependencies:
npm install
  1. Set your GitHub token as an environment variable:
export GITHUB_TOKEN=your_github_personal_access_token
  1. 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.