Project Brain MCP Server

by gentleelephantio.github.Gentleelephant/project-brainv2.0.3

Read-only source search and retrieval across configured GitHub repositories

Dockerstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Maintained2mo ago

Install Project Brain MCP server

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='<pb-github-token>' -- docker run -i --rm -e PROJECT_BRAIN_REPO_LIST -e PROJECT_BRAIN_STATE_DIR -e PB_GITHUB_TOKEN ghcr.io/gentleelephant/project-brain:v2.0.3

{
  "mcpServers": {
    "project-brain": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "PROJECT_BRAIN_REPO_LIST",
        "-e",
        "PROJECT_BRAIN_STATE_DIR",
        "-e",
        "PB_GITHUB_TOKEN",
        "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": "<pb-github-token>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "project-brain": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "PROJECT_BRAIN_REPO_LIST",
        "-e",
        "PROJECT_BRAIN_STATE_DIR",
        "-e",
        "PB_GITHUB_TOKEN",
        "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": "<pb-github-token>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "project-brain": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "PROJECT_BRAIN_REPO_LIST",
        "-e",
        "PROJECT_BRAIN_STATE_DIR",
        "-e",
        "PB_GITHUB_TOKEN",
        "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": "<pb-github-token>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "project-brain": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "PROJECT_BRAIN_REPO_LIST",
        "-e",
        "PROJECT_BRAIN_STATE_DIR",
        "-e",
        "PB_GITHUB_TOKEN",
        "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": "<pb-github-token>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

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

Freshness

Maintained — last maintenance signal 2mo ago. The newest of the signals below sets the band.

Last commit (default branch)
no data · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-08-08 · 2mo ago · official registry · v2.0.3

FAQ

›How do I install the Project Brain MCP server in Claude Code?

Run: 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='<pb-github-token>' -- docker run -i --rm -e PROJECT_BRAIN_REPO_LIST -e PROJECT_BRAIN_STATE_DIR -e PB_GITHUB_TOKEN ghcr.io/gentleelephant/project-brain:v2.0.3. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Project Brain require an API key?

Yes. It expects PROJECT_BRAIN_REPO_LIST, PROJECT_BRAIN_STATE_DIR, PB_GITHUB_TOKEN, of which 1 is a secret.

›Can I use Project Brain as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Project Brain in the official MCP registry?

Yes, as io.github.Gentleelephant/project-brain.