MCP.so
登录

GitHub Issue Searcher MCP Server

@calumjs

基本信息

分类

版本控制

许可证

MIT license

传输方式

stdio

作者

calumjs

关于 GitHub Issue Searcher MCP Server

🔍 A Model Context Protocol (MCP) server that provides semantic search capabilities for GitHub repository issues using FAISS and OpenAI embeddings. Perfect for developers who want to quickly find relevant issues, bug reports, and discussions across GitHub repositories using natur

GitHub Issue Searcher MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "GitHub.Issue.Searcher.MCP": {
      "command": "python",
      "args": [
        "-m",
        "venv",
        ".venv"
      ]
    }
  }
}

GitHub Issue Searcher MCP Server 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表,不代表服务没有工具。请查阅项目文档了解支持的能力。

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is GitHub Issue Searcher MCP?

GitHub Issue Searcher MCP is a Model Context Protocol (MCP) server that combines FAISS (Facebook AI Similarity Search) with OpenAI embeddings to provide semantic search for GitHub repository issues. It is designed for building Retrieval-Augmented Generation (RAG) systems and searchable knowledge bases from GitHub issue tracking data.

How to use GitHub Issue Searcher MCP?

Install Python 3.8+, set up a virtual environment, install dependencies, set OPENAI_API_KEY (and optionally GITHUB_PERSONAL_ACCESS_TOKEN) in a .env file. Run python sync_github.py owner/repo --clear to sync a repository. Configure the MCP client (e.g., Claude Desktop) to point to main.py. Then use MCP tools like search_embeddings to query natural language and get_index_status to inspect indexed data.

Key features of GitHub Issue Searcher MCP

  • Semantic search using OpenAI embeddings and FAISS
  • Document storage with rich metadata
  • Automatic syncing of GitHub repository issues
  • Fast similarity search powered by FAISS
  • Works seamlessly with Claude and other MCP clients
  • Persistent automatic saving of indexes and metadata

Use cases of GitHub Issue Searcher MCP

  • Semantically search through GitHub repository issues
  • Build searchable knowledge bases from GitHub issues
  • Enhance AI responses with relevant issue context (RAG)
  • Find similar bug reports, feature requests, or discussions
  • Troubleshoot developer support by searching issue history

常见问题

1

What are the dependencies and runtime requirements?

Python 3.8 or higher, an OpenAI API key, and optionally a GitHub Personal Access Token. Install required packages via `pip install -r requirements.txt`.

2

Where does the indexed data live?

The FAISS index is stored as `faiss_index.bin` and metadata as `metadata.json`, both inside a `data/` directory created automatically.

3

Can I add more repositories without losing existing data?

Yes, run `python sync_github.py owner/repo` without the `--clear` flag to append new repository data to the existing index.

4

How do I replace all data with a different repository?

Use the `--clear` flag when syncing: `python sync_github.py new-owner/new-repo --clear`.

5

What transport or protocol does the server use?

It implements the Model Context Protocol (MCP) and is configured to work with MCP clients like Claude Desktop via command-line invocation.

评论

版本控制 分类下的更多 MCP 服务器