English Français العربية

Project Brain

Official registry Developer tools

Read-only source search and retrieval across configured GitHub repositories

Source code

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

OCI package ghcr.io/gentleelephant/project-brain:v2.0.3
Claude Code 
claude mcp add project-brain -e 'PROJECT_BRAIN_REPO_LIST=<PROJECT_BRAIN_REPO_LIST>' -e 'PROJECT_BRAIN_STATE_DIR=<PROJECT_BRAIN_STATE_DIR>' -e 'PB_GITHUB_TOKEN=<your pb_github_token>' -e 'PB_FETCH_TTL=<PB_FETCH_TTL>' -- docker run -i --rm ghcr.io/gentleelephant/project-brain:v2.0.3
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "project-brain": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/gentleelephant/project-brain:v2.0.3"
            ],
            "env": {
                "PROJECT_BRAIN_REPO_LIST": "<PROJECT_BRAIN_REPO_LIST>",
                "PROJECT_BRAIN_STATE_DIR": "<PROJECT_BRAIN_STATE_DIR>",
                "PB_GITHUB_TOKEN": "<your pb_github_token>",
                "PB_FETCH_TTL": "<PB_FETCH_TTL>"
            }
        }
    }
}

Environment variables

  • PROJECT_BRAIN_REPO_LIST required Comma-separated owner/repo slugs or a path to a file with one slug per line
  • PROJECT_BRAIN_STATE_DIR required Writable directory for repository caches, indexes, and locks
  • PB_GITHUB_TOKEN secret Optional GitHub token for private repositories
  • PB_FETCH_TTL Minimum interval between on-demand repository refreshes

Frequently asked questions

What is Project Brain?

Read-only source search and retrieval across configured GitHub repositories

How do I install Project Brain?

It runs on your machine. In Claude Code: claude mcp add project-brain -e 'PROJECT_BRAIN_REPO_LIST=<PROJECT_BRAIN_REPO_LIST>' -e 'PROJECT_BRAIN_STATE_DIR=<PROJECT_BRAIN_STATE_DIR>' -e 'PB_GITHUB_TOKEN=<your pb_github_token>' -e 'PB_FETCH_TTL=<PB_FETCH_TTL>' -- docker run -i --rm ghcr.io/gentleelephant/project-brain:v2.0.3. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Project Brain need an API key?

Yes. It expects PROJECT_BRAIN_REPO_LIST, PROJECT_BRAIN_STATE_DIR, PB_GITHUB_TOKEN, which you set in its configuration.

Is Project Brain open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains Project Brain?

It is published by Gentleelephant. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.