mcp | Bootspring Docs

Manage MCP (Model Context Protocol) server connections.

Synopsis#

bootspring mcp <command> [options]

Description#

The mcp command manages MCP server connections and configurations. MCP enables AI assistants like Claude to interact with Bootspring tools directly.

Commands#

status#

Check MCP server status.

bootspring mcp status

Output:

⚡ MCP Server Status

Server: bootspring
Status: Running
Port: 3100
Uptime: 2h 15m

Connected Clients:
  ✓ Claude Desktop (claude-desktop-1.2.0)
  ✓ VS Code Extension (bootspring-vscode-0.8.0)

Tools Available: 19
  bootspring_assist, bootspring_context, bootspring_agent,
  bootspring_todo, bootspring_generate, bootspring_skill,
  bootspring_memory, bootspring_orchestrator, bootspring_prd,
  bootspring_loop, bootspring_seed, bootspring_dashboard,
  bootspring_quality, bootspring_workflow, bootspring_analyze,
  bootspring_config, bootspring_feedback, bootspring_status,
  bootspring_mvp

Resources: 4
  project://context, project://config, project://prd, project://todos

start#

Start the MCP server.

bootspring mcp start [options]

Options:

Option	Description
`--port=<n>`	Server port (default: 3100)
`--host=<addr>`	Host address (default: localhost)
`--stdio`	Use stdio transport (for Claude Desktop)
`--detach`	Run in background

Examples:

# Start with stdio (Claude Desktop)
bootspring mcp start --stdio

# Start on custom port
bootspring mcp start --port=3200

# Start in background
bootspring mcp start --detach

stop#

Stop the MCP server.

bootspring mcp stop

restart#

Restart the MCP server.

bootspring mcp restart

logs#

View MCP server logs.

bootspring mcp logs [options]

Options:

Option	Description
`--follow`, `-f`	Follow log output
`--lines=<n>`	Number of lines (default: 50)
`--level=<level>`	Filter by log level

Examples:

# View recent logs
bootspring mcp logs

# Follow logs
bootspring mcp logs -f

# Error logs only
bootspring mcp logs --level=error

tools#

List available MCP tools.

bootspring mcp tools [options]

Options:

Option	Description
`--verbose`	Show tool details
`--json`	Output as JSON

Output:

⚡ MCP Tools

Core Tools:
  bootspring_assist      Natural language assistant
  bootspring_context     Get project context
  bootspring_agent       Invoke expert agents
  bootspring_todo        Manage todos
  bootspring_generate    Regenerate context

Development Tools:
  bootspring_skill       Discover and apply skills
  bootspring_quality     Run quality gates
  bootspring_analyze     Analyze code

Workflow Tools:
  bootspring_orchestrator  Orchestrate workflows
  bootspring_workflow      Manage workflows
  bootspring_loop         Development loops
  bootspring_prd          PRD management
  bootspring_seed         Seed operations
  bootspring_mvp          MVP generation

System Tools:
  bootspring_memory      Access memory
  bootspring_dashboard   Dashboard control
  bootspring_config      Configuration
  bootspring_feedback    Send feedback
  bootspring_status      Check status

resources#

List MCP resources.

bootspring mcp resources

Output:

⚡ MCP Resources

project://context
  Project context (CLAUDE.md)
  MIME: text/markdown

project://config
  Bootspring configuration
  MIME: application/json

project://prd
  Product Requirements Document
  MIME: application/json

project://todos
  Todo list
  MIME: text/markdown

test#

Test MCP connection and tools.

bootspring mcp test [options]

Options:

Option	Description
`--tool=<name>`	Test specific tool
`--all`	Test all tools

Examples:

# Run all tests
bootspring mcp test --all

# Test specific tool
bootspring mcp test --tool=bootspring_assist

Output:

⚡ MCP Tests

Testing connection... ✓
Testing authentication... ✓

Tool Tests:
  ✓ bootspring_assist (45ms)
  ✓ bootspring_context (12ms)
  ✓ bootspring_agent (89ms)
  ✓ bootspring_todo (23ms)
  ... 15 more tools passed

All tests passed (19/19)

config#

Configure MCP settings.

bootspring mcp config [options]

Options:

Option	Description
`--set=<key>=<value>`	Set config value
`--get=<key>`	Get config value
`--show`	Show all config

Examples:

# Show config
bootspring mcp config --show

# Set port
bootspring mcp config --set=port=3200

# Get specific value
bootspring mcp config --get=transport

install#

Install MCP server for Claude Desktop.

bootspring mcp install [options]

Options:

Option	Description
`--global`	Install globally
`--config-only`	Update config only

This command:

Locates Claude Desktop config
Adds Bootspring MCP server entry
Configures stdio transport

Example:

# Install for Claude Desktop
bootspring mcp install

# Output:
# ✓ Found Claude Desktop config
# ✓ Added bootspring MCP server
# ✓ Configuration complete
#
# Restart Claude Desktop to connect

uninstall#

Remove MCP server from Claude Desktop.

bootspring mcp uninstall

Claude Desktop Integration#

Automatic Setup#

# Install and configure
bootspring mcp install

Manual Configuration#

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "bootspring": {
      "command": "bootspring",
      "args": ["mcp", "start", "--stdio"],
      "cwd": "/path/to/your/project"
    }
  }
}

Config Locations#

OS	Path
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Windows	`%APPDATA%\Claude\claude_desktop_config.json`
Linux	`~/.config/Claude/claude_desktop_config.json`

VS Code Integration#

Install Extension#

# Install Bootspring VS Code extension
code --install-extension bootspring.bootspring-vscode

Configure Extension#

In VS Code settings:

{
  "bootspring.mcp.enabled": true,
  "bootspring.mcp.port": 3100,
  "bootspring.mcp.autoStart": true
}

Configuration#

MCP settings in bootspring.config.js:

module.exports = {
  mcp: {
    // Server settings
    server: {
      port: 3100,
      host: 'localhost',
      transport: 'stdio', // or 'http'
    },

    // Tool configuration
    tools: {
      enabled: [
        'assist',
        'context',
        'agent',
        'todo',
        'generate',
        'skill',
        'quality',
        'workflow',
      ],

      // Tool-specific settings
      assist: {
        maxTokens: 4096,
      },

      agent: {
        timeout: 30000,
      },
    },

    // Resource configuration
    resources: {
      enabled: ['context', 'config', 'prd', 'todos'],
    },

    // Logging
    logging: {
      level: 'info',
      file: '.bootspring/logs/mcp.log',
    },
  },
};

Examples#

Start Server for Development#

# Start with logging
bootspring mcp start --detach
bootspring mcp logs -f

Diagnose Connection Issues#

# Check status
bootspring mcp status

# Run tests
bootspring mcp test --all

# Check logs for errors
bootspring mcp logs --level=error

Multiple Projects#

# Project A (port 3100)
cd /path/to/project-a
bootspring mcp start --port=3100 --detach

# Project B (port 3101)
cd /path/to/project-b
bootspring mcp start --port=3101 --detach

Configure Claude Desktop for multiple projects:

{
  "mcpServers": {
    "project-a": {
      "command": "bootspring",
      "args": ["mcp", "start", "--stdio"],
      "cwd": "/path/to/project-a"
    },
    "project-b": {
      "command": "bootspring",
      "args": ["mcp", "start", "--stdio"],
      "cwd": "/path/to/project-b"
    }
  }
}

Troubleshooting#

Server Won't Start#

# Check if port is in use
lsof -i :3100

# Try different port
bootspring mcp start --port=3200

Claude Desktop Not Connecting#

Check config file location
Verify JSON syntax
Restart Claude Desktop
Check MCP logs

bootspring mcp logs --level=error

Tools Not Available#

# Verify tools are enabled
bootspring mcp tools

# Check config
bootspring mcp config --show

# Test tools
bootspring mcp test --all

bootspring plugin - Plugin management
bootspring config - Configuration
bootspring status - System status

MCP Integration - Concepts
MCP Tools Reference - Tool documentation
Architecture - Protocol details