project-brain-mcp

MCP server that gives your AI coding tools persistent memory across sessions.

Your AI forgets everything when a session ends. Project Brain remembers — bugs you fixed, decisions you made, schema changes, project rules. Works with Claude Code, Cursor, Codex, and any MCP-compatible tool.

Quick start

{
  "mcpServers": {
    "project-brain": {
      "command": "npx",
      "args": ["-y", "project-brain-mcp"],
      "env": {
        "PROJECT_BRAIN_API_KEY": "your-api-key",
        "AWX_PROJECT_ID": "your-project-id"
      }
    }
  }
}

Add this to .claude/settings.local.json (Claude Code), .cursor/mcp.json (Cursor), or your tool's MCP config.

Get your API key at awx-shredder.fly.dev/app.

Tools

| Tool | What it does | |------|-------------| | init_project | Create or connect to a project brain | | remember | Save a memory — bug fix, decision, schema change, rule | | recall | Search memories by keyword or category | | get_context | Get full project state (recent changes, bugs, decisions, rules) |

How it works

1. Sign up at awx-shredder.fly.dev and get an API key
2. Add the MCP config above to your AI tool
3. Use init_project to create a brain for your project
4. Your AI tools now share memory — fix a bug in Claude Code, recall it in Cursor

GitHub App (optional)

Install the GitHub App to automatically capture PRs, issues, commits, and CI results — no manual remember() calls needed. The brain fills itself.

Connect at awx-shredder.fly.dev/app.

Environment variables

| Variable | Required | Description | |----------|----------|-------------| | PROJECT_BRAIN_API_KEY | Yes | Your API key | | AWX_PROJECT_ID | Yes | Your project ID (from init_project) | | PROJECT_BRAIN_URL | No | Custom API URL (default: https://awx-shredder.fly.dev) |

License

MIT