system-brain-mcp

Eleven read-only MCP tools for inspecting a software workspace and returning answers tied to observable evidence. Missing or degraded evidence produces a partial result or no recommendation, never invented certainty.

Start

npx -y -p system-brain-mcp system-brain-init /path/to/code

Or from source:

git clone https://github.com/QEbellavita/system-brain-mcp
cd system-brain-mcp
npm install
node bin/init.js /path/to/code

The initializer scans for repositories and deployment configuration, then writes a draft manifest. It leaves uncertain fields unresolved for human review.

Point an MCP client at the server:

{
  "mcpServers": {
    "system-brain": {
      "command": "npx",
      "args": ["-y", "system-brain-mcp"],
      "env": {
        "SYSTEM_BRAIN_DEPLOY_MANIFEST": "/path/to/deploy-targets.json",
        "SYSTEM_BRAIN_FABRICATION_DIRS": "/path/to/source"
      }
    }
  }
}

Related MCP server: repo-scout

Tools

All tools are read-only. They do not write to databases, repositories, or deployment targets.

Configuration

The files under config/ are neutral examples only. Copy them to user-specific files and replace every example table, label, taxonomy, and threshold before interpreting analytics. The project intentionally does not ship a production schema or recommended operating threshold.

brain_analytics measures labels within the configured outcome ledger. Other activity tables are reported separately so they cannot silently change that denominator. The tool reports incomplete evidence when a required query fails.

brain_fabrication_audit returns candidate locations, not verdicts. Read the surrounding implementation before classifying a capability.

Tests

npm test

Tests use temporary files and injected command behavior. Network access and a database are not required.

Public-data boundary

Public fixtures are synthetic. Do not add customer data, real internal identifiers, production table names, operating thresholds, incident details, or exact production-shaped examples to this repository or its release archives.

Licence

MIT. See LICENSE.