mcp find similar github issues

Local 2025-08-31 23:39:01 0
search @Jake-Mok-Nelson/mcp-find-similar-github-issues

Helps support engineers find similar GitHub issues to speed up troubleshooting by searching repositories and calculating similarity scores based on issue descriptions.

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.

[
  {
    "description": "Find GitHub issues similar to a new issue description",
    "inputSchema": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "additionalProperties": false,
      "properties": {
        "issueDescription": {
          "description": "Description of the issue to find similar ones for",
          "type": "string"
        },
        "maxResults": {
          "default": 5,
          "description": "Maximum number of similar issues to return",
          "maximum": 20,
          "minimum": 1,
          "type": "integer"
        },
        "owner": {
          "description": "GitHub repository owner/organization",
          "type": "string"
        },
        "repo": {
          "description": "GitHub repository name",
          "type": "string"
        }
      },
      "required": [
        "owner",
        "repo",
        "issueDescription"
      ],
      "type": "object"
    },
    "name": "find-similar-issues"
  }
]