GitHub Brain MCP Server

GitHub Brain is an experimental MCP server for summarizing GitHub discussions, issues, and pull requests. Answer questions like:

• What are the contributions of user X in the last month?
• Summarize this month's discussions.

https://github.com/user-attachments/assets/80910025-9d58-4367-af00-bf4c51e6ce86

GitHub Brain complements (but does not replace) the official GitHub MCP server. It stores GitHub data in a local database for:

• Fast responses
• More than the standard 100-item API limit
• Token-efficient Markdown output

GitHub Brain also includes a web-based UI for ultra-fast search:

And a Raycast extension:

GitHub Brain is programmed in Markdown.

Installation

npm i -g github-brain

Or use npx github-brain to run without installing globally.

Usage

github-brain <command> [<args>]

Workflow:

1. Use login to authenticate with GitHub (or set GITHUB_TOKEN manually)
2. Use pull to populate the local database
3. Use mcp to start the MCP server

Re-run pull anytime to update the database with new GitHub data.

Each command has its own arguments. Some can be set via environment variables. The app will also load environment variables from a .env file in the GitHub Brain's home directory - ~/.github-brain by default. You can change the home directory with the -m argument available for all commands.

GITHUB_TOKEN=your_github_token
ORGANIZATION=my-org

login

Opens your browser to authorize GitHub Brain app and stores resulting GITHUB_TOKEN in the .env file. Optionally, you can also specify ORGANIZATION to store in the same file.

Example:

github-brain login

pull

Populate the local database with GitHub data.

Example:

github-brain pull -o my-org

The first run may take a while. Subsequent runs are faster, fetching only new data.

Use [fine-grained personal access tokens](https://github.com/settings/personal-access-tokens).

**Private organizations:** Token needs read access to discussions, issues, metadata, and pull requests. [Generate token](https://github.com/settings/personal-access-tokens/new?name=github-brain&description=http%3A%2F%2Fgithub.com%2Fwham%2Fgithub-brain&issues=read&pull_requests=read&discussions=read).

**Public organizations:** Any token works (data is publicly accessible).

mcp

Start the MCP server using the local database.

Example:

github-brain mcp -o my-org

ui

Start the web UI for quick searches (alternative to MCP).

github-brain ui -o my-org

Additional Arguments

Version:

github-brain --version

Displays the current version (commit hash and build date).

MCP Configuration

Claude

Add to the Claude MCP configuration file:

{
  "mcpServers": {
    "github-brain": {
      "type": "stdio",
      "command": "github-brain",
      "args": ["mcp"]
    }
}

Merge with existing mcpServers if present.

VS Code

Add to the VS Code MCP configuration file:

{
  "servers": {
    "github-brain": {
      "type": "stdio",
      "command": "github-brain",
      "args": ["mcp"],
      "version": "0.0.1"
    }
  }
}

Merge with existing servers if present.

Raycast Extension

Run the Raycast extension with:

scripts/raycast

The extension uses the MCP server to search GitHub data.

Development

scripts/run builds and runs github-brain with the checkout directory as home -m (database in db/, config in .env).