README.md

GitHub Semantic Search

This project provides semantic search capabilities for GitHub repositories using the Model Context Protocol (MCP). It enables retrieval-augmented generation (RAG) queries against indexed GitHub repositories, supporting both public and private repos.

Components

• vscode-extension: VSCode extension for integration with Copilot Chat Window as MCP.
• workflow: Backend MCP server that handles indexing and search queries using Cloudflare infrastructure.
• config-packs: Configuration and packaging utilities for deployment.

Quick Start

MCP Configuration

{
  "mcpServers": {
    "github-semantic-search-server": {
      "type": "streamable-http",
      "url": "https://github-search.lokeel.com/mcp",
      "headers": {
        "GITHUB_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

1. Configure the MCP server in your IDE (see workflow README for setup instructions).
2. Use the semantic search tool by providing @owner and repository parameters.
3. If a repository hasn't been indexed yet, check back later as initial indexing takes time.

Features

• Semantic code search across GitHub repositories
• Support for private repositories
• Integration with VSCode and other MCP-compatible tools
• Cloudflare-powered backend for scalability

For detailed installation, deployment, and usage instructions, refer to the README files in each component directory.