mcp-find-similar-github-issues

🚀 GitHub 支持助手

GitHub 支持助手是一个 MCP 服务器，它能助力支持工程师在 GitHub 仓库中快速查找类似问题，显著加快故障排除的速度，提升工作效率。

🚀 快速开始

按照以下步骤完成安装和配置，即可开始使用 GitHub 支持助手。

📦 安装指南

安装依赖项

在项目根目录下执行以下命令安装所需依赖：

npm install

设置 GitHub 令牌

将你的 GitHub 令牌设置为环境变量：

export GITHUB_TOKEN=your_github_personal_access_token

构建服务器

运行以下命令来构建服务器：

npm run build

与 Claude 集成

更新 claude 桌面配置，可通过以下命令打开配置文件：

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

将配置文件内容更新为包含此存储库克隆到的完整路径：

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

✨ 主要特性

• 相似问题搜索：能够在 GitHub 仓库中精准搜索与给定描述相似的问题。
• 结果排名：通过计算相似性评分对搜索结果进行排名，方便快速定位最相关问题。
• 详细信息返回：返回格式化的故障问题详细信息和链接，便于查看具体情况。

💻 使用示例

find-similar-issues

该工具用于查找与给定描述相似的 GitHub 问题。

参数说明： | 参数 | 详情 | | ---- | ---- | | owner | GitHub 仓库所有者/组织 | | repo | GitHub 仓库名称 | | issueDescription | 要查找类似问题的问题描述 | | maxResults | 要返回的最大结果数（默认值为 5） |

🔧 技术细节

此实现采用简单的 Jaccard 相似度系数来比较文本。不过，对于生产用途，建议采用更复杂的 NLP 技术，这样能获得更好的相似性匹配效果。