BLACKBOXAI CLI

The BLACKBOXAI registry installer and manager for Model Context Protocol (MCP) servers, designed to be client-agnostic.

Requirements

• NodeJS version 18 or above

Usage

npx @blackboxai/cli <command>

Available Commands

• install <package> - Install a package
  • --client <name> - Specify the AI client
• uninstall <package> - Uninstall a package
  • --client <name> - Specify the AI client
• inspect <server-id> - Inspect a server interactively
• run <server-id> - Run a server
  • --config <json> - Provide configuration for the server
• --verbose - Show detailed logs for debugging

Examples

# Install a server (requires --client flag)
npx @blackboxai/cli install mcp-obsidian --client blackbox

# Remove a server
npx @blackboxai/cli uninstall mcp-obsidian --client blackbox

# Inpsect a specific server from blackboxai's registry
npx @blackboxai/cli inspect mcp-obsidian

# Run a server with configuration
npx @blackboxai/cli run mcp-obsidian --config '"{\\"key\\":\\"value\\"}"'

# Install with verbose logging for debugging
npx @blackboxai/cli install mcp-obsidian --client blackbox --verbose

Important Notes

• Remember to restart your AI client after installing or uninstalling servers
• Use the inspect command for interactive server testing
• Run without arguments to see the help menu
• Use --verbose flag for detailed logs when troubleshooting