Sourcebot

Name: Sourcebot
Author: sourcebot-dev

@sourcebot-dev

Repository

About Sourcebot

Fetch code context from multiple code hosts (GitHub, GitLab, Bitbucket, etc)

#code-context #cursor #copilot

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "sourcebot": {
      "command": "npx",
      "args": [
        "-y",
        "@sourcebot/mcp@latest"
      ]
    }
  }
}

Tools

Fetches code that matches the provided regex pattern in `query`. This is NOT a semantic search. Results are returned as an array of matching files, with the file's URL, repository, and language. If the `includeCodeSnippets` property is true, code snippets containing the matches will be included in the response. Only set this to true if the request requires code snippets (e.g., show me examples where library X is used). When referencing a file in your response, **ALWAYS** include the file's external URL as a link. This makes it easier for the user to view the file, even if they don't have it locally checked out. **ONLY USE** the `filterByRepoIds` property if the request requires searching a specific repo(s). Otherwise, leave it empty.

Lists all repositories in the organization.

Fetches the source code for a given file.

Overview

What is Sourcebot?

Sourcebot is the open source Sourcegraph alternative. It indexes all repos and branches across multiple code hosts (GitHub, GitLab, Bitbucket, Gitea, or Gerrit) and searches through them using a blazingly fast interface.

How to use Sourcebot?

Deploy Sourcebot in seconds using the official Docker image: create a config.json, run the provided docker run command, and start searching at http://localhost:3000. Full configuration details are available in the docs.

Key features of Sourcebot

One-command deployment using Docker.
Multi-repo search across GitHub, GitLab, Bitbucket, Gitea, Gerrit.
Lightning fast performance built on the Zoekt search engine.
Modern web app with syntax highlighting, light/dark mode, vim-style navigation.
Full file visualization showing the entire file for any search result.

Use cases of Sourcebot

Index and search multiple public and private repositories across different code hosts.
Search across multiple branches within repositories.
Self-host a fast, open source alternative to Sourcegraph.
Enable team‑wide code search without sending data to third‑party services.

FAQ from Sourcebot

What is the difference between Sourcebot and alternatives?

Sourcebot is an open source, self‑hosted Sourcegraph alternative designed for one‑command Docker deployment and multi‑repo search.

What are the system requirements to run Sourcebot?

Docker is required; the official Docker image from ghcr.io/sourcebot-dev/sourcebot:latest handles all dependencies.

Where does Sourcebot store data?

Sourcebot persists a .sourcebot cache and .zoekt index files in the mounted volume (specified with -v $(pwd):/data).

Does Sourcebot collect telemetry?

Yes, anonymous usage data is collected by default to help improve the product. No sensitive data is collected, and telemetry can be disabled by setting the environment variable SOURCEBOT_TELEMETRY_DISABLED=true.

What code host authentication does Sourcebot support?

Authentication is configured per connection in the config.json file (e.g., GitHub repos require a token if private). The README shows a starter connection using a public repo without explicit credentials.