second-brain-health-check

This MCP server exposes Claude Code health-check tooling as an embedded MCP service. The core tool, second-brain-health-check, analyzes your Claude Code “second brain” by running a full 45-layer health scan and generates adaptive reports, dashboards, and actionable fixes. You can start by adding the MCP entry with the npx-based runner, then invoke the available subcommands (check health, generate dashboards and PDFs, and access paid features if you provide a token). Use the provided CLI through MCP to run checks locally without network calls for the free tools, and leverage paid tools for ongoing tracking and deeper analysis.

To use it, install prerequisites (Node.js v20+, npm), set up the MCP integration, and run the MCP command via npx second-brain-health-check. You can perform a full health check, generate a self-contained HTML dashboard, or export a PDF report. If you want to use paid capabilities like weekly_pulse or context_pressure, supply your SBF_TOKEN in the environment and re-run the setup to enable those features. The workflow supports interactive onboarding, quick checks, and targeted fixes, all accessible through the MCP-exposed commands.

Prerequisites:

• Node.js v20 or newer installed on your system
• npm (Node Package Manager) available
• MCP-compatible setup if you are integrating via MCP (as shown in the README)

Installation steps:

1. Ensure Node.js is installed
   • Check: node -v
   • Check npm: npm -v
2. Use the MCP entrypoint to install/run the health check via npx

# One-command setup via MCP (recommended)
npx second-brain-health-check setup

3. If you prefer manual MCP integration, add the MCP server entry:

claude mcp add second-brain-health -- npx second-brain-health-check

4. Run the health check through MCP:

npx second-brain-health-check

5. Optional: generate a dashboard or PDF:

npx second-brain-health-check --pdf

Notes:

• The free tools run locally with zero network calls. Paid tools require an API key and environment variable SBF_TOKEN.

Environment and configuration tips:

• For paid features, set SBF_TOKEN in your environment or run the setup to configure credentials.
• The MCP integration uses npx to fetch and run the second-brain-health-check package; ensure you have internet access for initial setup and updates.
• If you encounter permission errors on Linux/macOS, consider running with sudo cautiously or adjust npm permissions.
• The health check supports multiple languages and modes (full, quick, manifest); use mode=quick for a fast scan and mode=manifest to get YAML/structured output.
• Ensure your Claude Code environment is accessible to the tool or provide the necessary project paths to scan.
• For best results, run the health check in the root of your Second Brain project to collect accurate metrics.