npm package: @mcpbodega/cli
Description: Universal CLI for deploying and managing MCPs across all AI platforms
Author: CycleCore Technologies
Latest version: 0.4.0

# @mcpbodega/cli

Universal CLI for deploying and managing MCPs across all AI platforms.

## Installation

```bash
npm install -g @mcpbodega/cli
```

## Quick Start

```bash
# Login
mcpbodega login

# Initialize (after magic link)
mcpbodega init

# List available MCPs
mcpbodega list

# Deploy an MCP
mcpbodega add github

# Chain multiple MCPs
mcpbodega chain github slmbench resend

# View your deployed MCPs
mcpbodega status

# Remove an MCP
mcpbodega remove github
```

## Features

- 🚀 **One-Command Deployment** - `mcpbodega add <mcp>` deploys and configures everything
- 🔗 **Auto-Chaining** - Create pipes that save 50-80% on token costs
- 🤖 **Multi-Platform** - Auto-configures Claude, GPT, Grok, and more
- 📊 **Status Monitoring** - Track all your deployed MCPs
- ⚡ **Fast & Simple** - No complex setup, just ship

## Commands

### `mcpbodega login`
Authenticate with MCPBodega using magic link

### `mcpbodega init`
Initialize CLI configuration (run after clicking magic link)

### `mcpbodega add <mcp>`
Deploy an MCP and auto-configure for your AI platform

Options:
- `-n, --name <name>` - Custom name for this deployment
- `-e, --env <pairs...>` - Environment variables (KEY=VALUE)
- `--no-config` - Skip auto-configuration

### `mcpbodega list`
List available MCPs in the catalog

Options:
- `-c, --category <category>` - Filter by category
- `-t, --tag <tag>` - Filter by tag
- `--deployed` - Show only your deployed MCPs

### `mcpbodega chain <mcps...>`
Create a pipe chain from multiple MCPs

Options:
- `-n, --name <name>` - Name for this pipe
- `-o, --output` - Print pipe URL without deploying

Example:
```bash
mcpbodega chain github slmbench resend
# Creates: /pipe/github-to-slmbench-to-resend
# Result: ~50-80% token savings vs separate calls
```

### `mcpbodega status`
Show status of your deployed MCPs

Options:
- `-v, --verbose` - Show detailed information
- `--json` - Output as JSON

### `mcpbodega remove <mcp>`
Remove a deployed MCP

Options:
- `-y, --yes` - Skip confirmation

## Auto-Configuration

The CLI automatically configures your AI platforms:

### Claude Desktop
- Detects Claude config file
- Adds MCP URL automatically
- Updates on deploy/remove

### GPT
- Provides setup instructions
- Copy-paste URL into Developer Mode

### Grok
- Provides code snippet for xAI SDK
- Easy integration with Grok API

## Configuration

Config is stored in `~/.mcpbodega/config.json`

```json
{
  "apiUrl": "https://mcpbodega.com",
  "authToken": "your-token",
  "email": "you@example.com",
  "autoConfig": {
    "claude": true,
    "gpt": true,
    "grok": true
  }
}
```

## Examples

### Deploy GitHub MCP
```bash
mcpbodega add github
# ✓ Deploys to MCPBodega
# ✓ Auto-configures Claude
# ✓ Shows GPT/Grok instructions
```

### Chain for Complex Workflows
```bash
# Extract repo data → Evaluate → Email results
mcpbodega chain github slmbench resend

# Use the pipe URL in your AI:
# https://mcpbodega.com/pipe/github-to-slmbench-to-resend
```

### Deploy with Custom Config
```bash
mcpbodega add postgres \
  -n "my-analytics-db" \
  -e DATABASE_URI=postgres://... \
  -e MAX_CONNECTIONS=10
```

## Troubleshooting

### "Not authenticated"
Run `mcpbodega login` then `mcpbodega init` with your auth token

### "MCP not found"
Check available MCPs with `mcpbodega list`

### Claude not detecting MCP
Restart Claude Desktop after deployment

## Development

```bash
# Clone repo
git clone https://github.com/cyclecore/mcpbodega

# Install dependencies
cd packages/cli
npm install

# Build
npm run build

# Test locally
npm link
```

## License

MIT © CycleCore Technologies