Project Brain
Rank #41,531io.github.Gentleelephant/project-brain
Read-only source search and retrieval across configured GitHub repositories
Project Brain is a Model Context Protocol (MCP) server published by Gentleelephant. It ranks #41,531 of 137,492 servers tracked on MCP Toplist. Project Brain is listed on Official MCP, with 7 tracked versions. It was first listed on Aug 6, 2026 and most recently updated on Aug 8, 2026.
Ranks ahead of 95,961 of 137,492 servers on MCP Toplist.
Use Project Brain
Requires user-supplied configuration before first use — typically an API key, token or connection string set via environment variables.
claude mcp add project-brain -e "PROJECT_BRAIN_REPO_LIST=<your PROJECT_BRAIN_REPO_LIST>" -e "PROJECT_BRAIN_STATE_DIR=<your PROJECT_BRAIN_STATE_DIR>" -e "PB_GITHUB_TOKEN=<your PB_GITHUB_TOKEN>" -e "PB_FETCH_TTL=<your PB_FETCH_TTL>" -- docker run -i --rm ghcr.io/gentleelephant/project-brain:v2.0.3Replace each placeholder with your own value before saving.
[mcp_servers.project-brain]
command = "docker"
args = ["run", "-i", "--rm", "ghcr.io/gentleelephant/project-brain:v2.0.3"]
[mcp_servers.project-brain.env]
PROJECT_BRAIN_REPO_LIST = "<your PROJECT_BRAIN_REPO_LIST>"
PROJECT_BRAIN_STATE_DIR = "<your PROJECT_BRAIN_STATE_DIR>"
PB_GITHUB_TOKEN = "<your PB_GITHUB_TOKEN>"
PB_FETCH_TTL = "<your PB_FETCH_TTL>"Add to ~/.codex/config.toml. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"project-brain": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/gentleelephant/project-brain:v2.0.3"
],
"env": {
"PROJECT_BRAIN_REPO_LIST": "<your PROJECT_BRAIN_REPO_LIST>",
"PROJECT_BRAIN_STATE_DIR": "<your PROJECT_BRAIN_STATE_DIR>",
"PB_GITHUB_TOKEN": "<your PB_GITHUB_TOKEN>",
"PB_FETCH_TTL": "<your PB_FETCH_TTL>"
}
}
}
}Add to claude_desktop_config.json (Settings → Developer → Edit Config). Replace each placeholder with your own value before saving.
{
"mcpServers": {
"project-brain": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/gentleelephant/project-brain:v2.0.3"
],
"env": {
"PROJECT_BRAIN_REPO_LIST": "<your PROJECT_BRAIN_REPO_LIST>",
"PROJECT_BRAIN_STATE_DIR": "<your PROJECT_BRAIN_STATE_DIR>",
"PB_GITHUB_TOKEN": "<your PB_GITHUB_TOKEN>",
"PB_FETCH_TTL": "<your PB_FETCH_TTL>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project). Replace each placeholder with your own value before saving.
{
"servers": {
"project-brain": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/gentleelephant/project-brain:v2.0.3"
],
"env": {
"PROJECT_BRAIN_REPO_LIST": "<your PROJECT_BRAIN_REPO_LIST>",
"PROJECT_BRAIN_STATE_DIR": "<your PROJECT_BRAIN_STATE_DIR>",
"PB_GITHUB_TOKEN": "<your PB_GITHUB_TOKEN>",
"PB_FETCH_TTL": "<your PB_FETCH_TTL>"
}
}
}
}Save as .vscode/mcp.json in your workspace. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"project-brain": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/gentleelephant/project-brain:v2.0.3"
],
"env": {
"PROJECT_BRAIN_REPO_LIST": "<your PROJECT_BRAIN_REPO_LIST>",
"PROJECT_BRAIN_STATE_DIR": "<your PROJECT_BRAIN_STATE_DIR>",
"PB_GITHUB_TOKEN": "<your PB_GITHUB_TOKEN>",
"PB_FETCH_TTL": "<your PB_FETCH_TTL>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"project-brain": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/gentleelephant/project-brain:v2.0.3"
],
"env": {
"PROJECT_BRAIN_REPO_LIST": "<your PROJECT_BRAIN_REPO_LIST>",
"PROJECT_BRAIN_STATE_DIR": "<your PROJECT_BRAIN_STATE_DIR>",
"PB_GITHUB_TOKEN": "<your PB_GITHUB_TOKEN>",
"PB_FETCH_TTL": "<your PB_FETCH_TTL>"
}
}
}
}Replace each placeholder with your own value before saving.
Show your rank
Maintain this server? Add the live rank badge to your README — it updates automatically as the leaderboard changes.
[](https://mcptoplist.com/server/io.github.Gentleelephant%2Fproject-brain)<a href="https://mcptoplist.com/server/io.github.Gentleelephant%2Fproject-brain"><img src="https://mcptoplist.com/badge/io.github.Gentleelephant%2Fproject-brain.svg" alt="MCP Toplist: Top 50% of 137,492" /></a>Variants: append ?metric=score or ?metric=stars to the image URL.
Listed on 1 registry
Gentleelephant
Available versions (7)
| Version | Published |
|---|---|
| 2.0.3 | Aug 8, 2026 |
| 2.0.2 | Aug 7, 2026 |
| 2.0.1 | Aug 7, 2026 |
| 2.0.0 | Aug 7, 2026 |
| 1.5.0 | Aug 7, 2026 |
| 1.4.1 | Aug 6, 2026 |
| 1.4.0 | Aug 6, 2026 |
Frequently asked questions
- Who maintains Project Brain?
- Project Brain is maintained by Gentleelephant, which publishes 1 MCP server (7 total versions) tracked on MCP Toplist.
- Is Project Brain listed on the Official MCP Registry?
- Yes — Project Brain is listed on the Official MCP Registry.
- How many versions does Project Brain have?
- MCP Toplist tracks 7 versions of Project Brain, most recently published on Aug 8, 2026.
- Where can I find the source code for Project Brain?
- The source code for Project Brain is hosted at github.com/Gentleelephant/project-brain.
Do you run this server?
Community projects list the MCP servers behind real agents and apps. Publish yours and this page will link to it.