bootspring doctor

Diagnose and verify your Bootspring setup.

Overview#

The doctor command checks your system configuration, dependencies, and Bootspring installation to identify and help resolve setup issues.

Usage#

bootspring doctor

What It Checks#

System#

  • Node.js version compatibility
  • Global installation status
  • Installation path

Dependencies#

  • MCP SDK availability
  • Zod schema validation
  • MCP protocol modules
  • MCP registry (tools and resources)

Configuration#

  • Claude Code config presence
  • Project .mcp.json (optional)
  • bootspring.config.js (optional)

Example Output#

⚡ Bootspring Doctor Checking your setup... System ✓ Node.js version Node.js v20.0.0 ✓ Global installation /usr/local/bin/bootspring Dependencies ✓ MCP SDK @modelcontextprotocol/sdk@1.0.0 ✓ Zod zod@3.22.0 ✓ MCP protocol MCP protocol modules loaded ✓ MCP registry 20 tools, 9 resources registered Configuration ✓ Claude Code config Found in ~/.claude/settings.json ! Project .mcp.json No .mcp.json in project (optional) ! bootspring.config.js No bootspring.config.js (optional) Summary Passed: 7 Warnings: 2

Status Icons#

IconMeaning
Check passed
!Warning (optional item)
Error (requires action)

Common Issues#

Node.js Version#

Bootspring requires Node.js 18 or higher.

1# Check version 2node --version 3 4# Update if needed 5nvm install 20 6nvm use 20

MCP SDK Missing#

The MCP SDK is required for AI assistant integration.

# Reinstall bootspring npm install -g @girardmedia/bootspring

Claude Code Config Not Found#

Bootspring needs to be configured in Claude Code.

# Initialize in Claude Code settings bootspring mcp