{"id":34585386,"url":"https://github.com/wham/github-brain","last_synced_at":"2026-02-03T01:25:19.984Z","repository":{"id":304851506,"uuid":"993994127","full_name":"wham/github-brain","owner":"wham","description":"An experimental MCP server that summarizes GitHub discussions, issues, and pull requests using a fast local database.","archived":false,"fork":false,"pushed_at":"2025-12-25T00:47:54.000Z","size":1613,"stargazers_count":67,"open_issues_count":0,"forks_count":16,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-25T22:07:41.835Z","etag":null,"topics":["github","golang","graphql","mcp","mcp-server","sqllite"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wham.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-06-01T00:44:02.000Z","updated_at":"2025-12-24T08:11:25.000Z","dependencies_parsed_at":"2025-07-16T15:00:23.203Z","dependency_job_id":"7a54996f-df17-4ed9-a56f-5b25fddaf646","html_url":"https://github.com/wham/github-brain","commit_stats":null,"previous_names":["wham/github-brain"],"tags_count":34,"template":false,"template_full_name":null,"purl":"pkg:github/wham/github-brain","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wham%2Fgithub-brain","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wham%2Fgithub-brain/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wham%2Fgithub-brain/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wham%2Fgithub-brain/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wham","download_url":"https://codeload.github.com/wham/github-brain/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wham%2Fgithub-brain/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28069212,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-12-27T02:00:05.897Z","response_time":58,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["github","golang","graphql","mcp","mcp-server","sqllite"],"created_at":"2025-12-24T10:30:04.700Z","updated_at":"2026-02-03T01:25:19.977Z","avatar_url":"https://github.com/wham.png","language":"Go","readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"logo.svg\" alt=\"GitHub Brain Logo\" width=\"150\" height=\"150\"\u003e\n  \u003ch1\u003eGitHub Brain MCP Server\u003c/h1\u003e\n\u003c/div\u003e\n\n**GitHub Brain** is an experimental MCP server for summarizing GitHub discussions, issues, and pull requests. Answer questions like:\n\n- _What are the contributions of user X in the last month?_\n- _Summarize this month's discussions._\n\nhttps://github.com/user-attachments/assets/80910025-9d58-4367-af00-bf4c51e6ce86\n\nGitHub Brain complements (but does not replace) the [official GitHub MCP server](https://github.com/github/github-mcp-server). It stores GitHub data in a local database for:\n\n- Fast responses\n- More than the standard 100-item API limit\n- Token-efficient Markdown output\n\n![](./docs/pull.png)\n\nGitHub Brain is [programmed in Markdown](https://github.blog/ai-and-ml/generative-ai/spec-driven-development-using-markdown-as-a-programming-language-when-building-with-ai/).\n\n## Installation\n\n```sh\nnpm i -g github-brain\n```\n\nRerun to update. `sudo` may be required on some systems.\n\nAlternatively use `npx` to run without installing globally and needing `sudo`.\n\n```sh\nnpx github-brain@latest\n```\n\n## Usage\n\n```sh\ngithub-brain\n```\n\nOr with `npx`:\n\n```sh\nnpx github-brain@latest\n```\n\nLaunches the interactive TUI where you can:\n\n1. **Setup** - Configure authentication and settings\n   - Login with GitHub (OAuth) - Recommended for most users\n   - Login with Personal Access Token - For fine-grained tokens or when OAuth is unavailable\n   - Open configuration file - Edit `.env` directly\n2. **Pull** - Populate the local database with GitHub data\n\nRe-run pull anytime to update the database with new GitHub data.\n\nThe app loads environment variables from a `.env` file in the GitHub Brain's home directory - `~/.github-brain` by default.\n\n\u003cdetails\u003e\n    \u003csummary\u003eExample .env file\u003c/summary\u003e\n\n    GITHUB_TOKEN=your_github_token\n    ORGANIZATION=my-org\n\n\u003c/details\u003e\n\n| Argument | Description                                |\n| :------- | :----------------------------------------- |\n| `-m`     | Home directory. Default: `~/.github-brain` |\n\n\u003cdetails\u003e\n    \u003csummary\u003ePersonal access token scopes\u003c/summary\u003e\n\n    Use [fine-grained personal access tokens](https://github.com/settings/personal-access-tokens).\n\n    **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\u0026description=http%3A%2F%2Fgithub.com%2Fwham%2Fgithub-brain\u0026issues=read\u0026pull_requests=read\u0026discussions=read).\n\n    **Public organizations:** Any token works (data is publicly accessible).\n\n\u003c/details\u003e\n\n## MCP Server\n\nStart the MCP server using the local database:\n\n```sh\ngithub-brain mcp\n```\n\nOr with `npx`:\n\n```sh\nnpx github-brain@latest mcp\n```\n\n| Argument | Variable       | Description                                |\n| :------- | :------------- | :----------------------------------------- |\n| `-o`     | `ORGANIZATION` | GitHub organization. **Required.**         |\n| `-m`     |                | Home directory. Default: `~/.github-brain` |\n\n## MCP Configuration\n\n### Claude\n\nAdd to the Claude MCP configuration file:\n\n```json\n{\n  \"mcpServers\": {\n    \"github-brain\": {\n      \"type\": \"stdio\",\n      \"command\": \"github-brain\",\n      \"args\": [\"mcp\"]\n    }\n}\n```\n\nOr with `npx`:\n\n```json\n{\n  \"mcpServers\": {\n    \"github-brain\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"github-brain@latest\", \"mcp\"]\n    }\n}\n```\n\nMerge with existing `mcpServers` if present.\n\n### VS Code\n\nAdd to the VS Code MCP configuration file:\n\n```json\n{\n  \"servers\": {\n    \"github-brain\": {\n      \"type\": \"stdio\",\n      \"command\": \"github-brain\",\n      \"args\": [\"mcp\"],\n      \"version\": \"0.0.1\"\n    }\n  }\n}\n```\n\nOr with `npx`:\n\n```json\n{\n  \"servers\": {\n    \"github-brain\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"github-brain@latest\", \"mcp\"],\n      \"version\": \"0.0.1\"\n    }\n  }\n}\n```\n\nMerge with existing `servers` if present.\n\n## Development\n\n`scripts/run` builds and runs `github-brain` with the checkout directory as home `-m` (database in `db/`, config in `.env`).\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwham%2Fgithub-brain","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwham%2Fgithub-brain","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwham%2Fgithub-brain/lists"}