From the README

# brain-mcp-server

A generic MCP server that serves Markdown-based AI Brain files to any MCP-compatible Claude client.

## What It Does

Gives Claude persistent, context-aware access to a collection of Markdown files (an "AI Brain") via the [Model Context Protocol](https://modelcontextprotocol.io). Supports reading, writing, searching, and git-backed versioning — all over local stdio transport.

## Tools

| Tool | Description |
|------|-------------|
| `brain_load_context` | Entry point — returns the loader + NOW.md |
| `brain_read_file` | Read a specific Brain file by name |
| `brain_update_file` | Update a Brain file (replace or append) |
| `brain_commit` | Git commit changes, optionally push |
| `brain_list_files` | List all files with staleness metadata |
| `brain_search` | Search across all Brain files |

## Requirements

- Node.js 18+
- A directory of Markdown files (your "Brain") with at least `00_loader.md` and `NOW.md`
- Git initialised in the Brain directory (for commit/push